ClickHouse/docs/ja/sql-reference/functions/url-functions.md

210 lines
7.8 KiB
Markdown
Raw Normal View History

2020-04-04 09:15:31 +00:00
---
machine_translated: true
machine_translated_rev: 72537a2d527c63c07aa5d2361a8829f3895cf2bd
2020-04-04 09:15:31 +00:00
toc_priority: 54
toc_title: "Url\u306E\u64CD\u4F5C"
---
# Urlを操作するための関数 {#functions-for-working-with-urls}
これらの関数はすべてRFCに従っていません。 それらは改善された性能のために最大限に簡単にされる。
2020-04-04 09:15:31 +00:00
## URLの一部を抽出する関数 {#functions-that-extract-parts-of-a-url}
関連する部分がURLにない場合は、空の文字列が返されます。
2020-04-04 09:15:31 +00:00
### プロトコル {#protocol}
URLからプロトコルを抽出します。
Examples of typical returned values: http, https, ftp, mailto, tel, magnet…
### ドメイン {#domain}
URLからホスト名を抽出します。
``` sql
domain(url)
```
**パラメータ**
- `url` — URL. Type: [文字列](../../sql-reference/data-types/string.md).
2020-04-04 09:15:31 +00:00
URLは、スキームの有無にかかわらず指定できます。 例:
``` text
svn+ssh://some.svn-hosting.com:80/repo/trunk
some.svn-hosting.com:80/repo/trunk
https://yandex.com/time/
```
これらの例では、 `domain` 関数は、次の結果を返します:
``` text
some.svn-hosting.com
some.svn-hosting.com
yandex.com
```
**戻り値**
- ホスト名。 ClickHouseが入力文字列をURLとして解析できる場合。
- 空の文字列。 ClickHouseが入力文字列をURLとして解析できない場合。
2020-04-04 09:15:31 +00:00
タイプ: `String`.
**例**
2020-04-04 09:15:31 +00:00
``` sql
SELECT domain('svn+ssh://some.svn-hosting.com:80/repo/trunk')
```
``` text
┌─domain('svn+ssh://some.svn-hosting.com:80/repo/trunk')─┐
│ some.svn-hosting.com │
└────────────────────────────────────────────────────────┘
```
### domainWithoutWWW {#domainwithoutwww}
2020-04-04 09:15:31 +00:00
ドメインを返し、複数のドメインを削除しません www. それの始めから、存在する場合。
2020-04-04 09:15:31 +00:00
### トップレベルドメイン {#topleveldomain}
2020-04-04 09:15:31 +00:00
URLからトップレベルドメインを抽出します。
``` sql
topLevelDomain(url)
```
**パラメータ**
- `url` — URL. Type: [文字列](../../sql-reference/data-types/string.md).
2020-04-04 09:15:31 +00:00
URLは、スキームの有無にかかわらず指定できます。 例:
``` text
svn+ssh://some.svn-hosting.com:80/repo/trunk
some.svn-hosting.com:80/repo/trunk
https://yandex.com/time/
```
**戻り値**
- ドメイン名。 ClickHouseが入力文字列をURLとして解析できる場合。
- 空の文字列。 ClickHouseが入力文字列をURLとして解析できない場合。
2020-04-04 09:15:31 +00:00
タイプ: `String`.
**例**
2020-04-04 09:15:31 +00:00
``` sql
SELECT topLevelDomain('svn+ssh://www.some.svn-hosting.com:80/repo/trunk')
```
``` text
┌─topLevelDomain('svn+ssh://www.some.svn-hosting.com:80/repo/trunk')─┐
│ com │
└────────────────────────────────────────────────────────────────────┘
```
### firstSignificantSubdomain {#firstsignificantsubdomain}
2020-04-04 09:15:31 +00:00
を返す。 “first significant subdomain”. これはYandexに固有の非標準的な概念です。メトリカ 最初の重要なサブドメインは、次の場合にセカンドレベルドメインです com, net, org,または co. それ以外の場合は、サードレベルドメインです。 例えば, `firstSignificantSubdomain (https://news.yandex.ru/) = yandex, firstSignificantSubdomain (https://news.yandex.com.tr/) = yandex`. のリスト “insignificant” セカンドレベルドメイ
2020-04-04 09:15:31 +00:00
### cutToFirstSignificantSubdomain {#cuttofirstsignificantsubdomain}
トップレベルのサブドメインを含むドメインの一部を返します。 “first significant subdomain” (上記の説明を参照)。
2020-04-04 09:15:31 +00:00
例えば, `cutToFirstSignificantSubdomain('https://news.yandex.com.tr/') = 'yandex.com.tr'`.
### パス {#path}
パスを返します。 例: `/top/news.html` パスにはクエリ文字列は含まれません。
2020-04-04 09:15:31 +00:00
### パスフル {#pathfull}
2020-04-04 09:15:31 +00:00
上記と同じですが、クエリ文字列とフラグメントを含みます。 例:/top/news.html?ページ=2\#コメント
2020-04-04 09:15:31 +00:00
### クエリ文字列 {#querystring}
クエリ文字列を返します。 例:ページ=1&lr=213. query-stringには、最初の疑問符だけでなく、\#と\#の後のすべても含まれていません。
2020-04-04 09:15:31 +00:00
### 断片 {#fragment}
フラグメント識別子を返します。 fragmentには初期ハッシュ記号は含まれません。
2020-04-04 09:15:31 +00:00
### queryStringAndFragment {#querystringandfragment}
クエリ文字列とフラグメント識別子を返します。 例:ページ=1\#29390.
### extractURLParameter(URL,名前) {#extracturlparameterurl-name}
の値を返します。 name URLにパラメータがある場合。 それ以外の場合は、空の文字列です。 この名前のパラメーターが多い場合は、最初に出現するパラメーターを返します。 この関数は、パラメータ名が渡された引数とまったく同じ方法でURLにエンコードされるという前提の下で機能します。
2020-04-04 09:15:31 +00:00
### extractURLParameters(URL) {#extracturlparametersurl}
URLパラメーターに対応するname=value文字列の配列を返します。 値はどのような方法でもデコードされません。
2020-04-04 09:15:31 +00:00
### extractURLParameterNames(URL) {#extracturlparameternamesurl}
URLパラメーターの名前に対応する名前文字列の配列を返します。 値はどのような方法でもデコードされません。
2020-04-04 09:15:31 +00:00
### URLHierarchy(URL) {#urlhierarchyurl}
URLを含む配列を返します。 パスとクエリ文字列で。 連続セパレータ文字として数えます。 カットは、すべての連続した区切り文字の後の位置に行われます。
2020-04-04 09:15:31 +00:00
### URLPathHierarchy(URL) {#urlpathhierarchyurl}
上記と同じですが、結果にプロトコルとホストはありません。 要素(ルート)は含まれません。 例関数は、ツリーを実装するために使用されるYandexの中のURLを報告します。 メートル法
2020-04-04 09:15:31 +00:00
``` text
URLPathHierarchy('https://example.com/browse/CONV-6788') =
[
'/browse/',
'/browse/CONV-6788'
]
```
### decodeURLComponent(URL) {#decodeurlcomponenturl}
デコードしたURLを返します。
例:
2020-04-04 09:15:31 +00:00
``` sql
SELECT decodeURLComponent('http://127.0.0.1:8123/?query=SELECT%201%3B') AS DecodedURL;
```
``` text
┌─DecodedURL─────────────────────────────┐
│ http://127.0.0.1:8123/?query=SELECT 1; │
└────────────────────────────────────────┘
```
## URLの一部を削除する関数 {#functions-that-remove-part-of-a-url}
2020-04-04 09:15:31 +00:00
URLに類似のものがない場合、URLは変更されません。
2020-04-04 09:15:31 +00:00
### cutWWW {#cutwww}
複数を削除しません www. URLのドメインの先頭から存在する場合。
2020-04-04 09:15:31 +00:00
### cutQueryString {#cutquerystring}
クエリ文字列を削除します。 疑問符も削除されます。
### カットフラグメント {#cutfragment}
フラグメント識別子を削除します。 番号記号も削除されます。
### cutQueryStringAndFragment {#cutquerystringandfragment}
クエリ文字列とフラグメント識別子を削除します。 疑問符と番号記号も削除されます。
### cutURLParameter(URL,名前) {#cuturlparameterurl-name}
を削除します。 name URLパラメータが存在する場合。 この関数は、パラメータ名が渡された引数とまったく同じ方法でURLにエンコードされるという前提の下で機能します。
2020-04-04 09:15:31 +00:00
[元の記事](https://clickhouse.tech/docs/en/query_language/functions/url_functions/) <!--hide-->