NET_PUBLIC_SUFFIX - MaxCompute

Fungsi NET_PUBLIC_SUFFIX mengurai sufiks publik, seperti com, org, atau net, dari string URL.

Catatan

Sufiks publik adalah domain ICANN yang terdaftar di publicsuffix.org. Data sufiks publik di publicsuffix.org juga mencakup domain pribadi. Fungsi ini mengabaikan domain pribadi.

Sintaksis

STRING NET_PUBLIC_SUFFIX(STRING <url>)

Parameter

url: Diperlukan. String URL untuk diurai. Parameter ini harus bertipe STRING.

Catatan

Untuk hasil terbaik, string URL harus sesuai dengan format yang didefinisikan dalam RFC 3986.

Nilai pengembalian

Mengembalikan nilai bertipe STRING. Fungsi ini mengembalikan NULL jika salah satu kondisi berikut berlaku:

Hostname tidak dapat diurai dari string URL.
Hostname yang diurai mengandung titik-titik berurutan yang tidak berada di awal atau akhir.
Hostname yang diurai tidak mengandung sufiks publik.

Catatan

Data sufiks publik dapat berubah seiring waktu. Oleh karena itu, input yang saat ini mengembalikan nilai NULL mungkin mengembalikan nilai non-NULL di masa mendatang.

Fungsi penguraian terkait

Untuk mengurai bagian lain dari URL selain sufiks publik, gunakan fungsi berikut:

NET_HOST: Menguraikan hostname dari URL.
NET_REG_DOMAIN: Mengurai domain terdaftar atau domain yang dapat didaftarkan dari URL (sufiks publik ditambah label sebelumnya).

Contoh

SELECT input
,description
,NET_HOST(input) AS HOST
,NET_PUBLIC_SUFFIX(input) AS SUFFIX
,NET_REG_DOMAIN(input) AS DOMAIN  
FROM (
  SELECT "" AS input, "input tidak valid" AS description
  UNION ALL SELECT "http://abc.xyz", "URL standar"
  UNION ALL SELECT "//user:password@a.b:80/path?query",
                   "URL standar dengan skema relatif, port, path dan query, tetapi tanpa sufiks publik"
  UNION ALL SELECT "https://[::1]:80", "URL standar dengan host IPv6"
  UNION ALL SELECT "http://example.web.china", "URL standar dengan nama domain internasional"
  UNION ALL SELECT "    www.Example.Co.UK    ",
                   "URL non-standar dengan spasi, huruf kapital, dan tanpa skema"
  UNION ALL SELECT "mailto:?to=&subject=&body=", "URI bukan URL--tidak didukung"
);

+-----------------------------------+-------------------------------------------------------------------------------+-------------------+------------+---------------+
| input                             | description                                                                   | host              | suffix     | domain        | 
+-----------------------------------+-------------------------------------------------------------------------------+-------------------+------------+---------------+
|                                   | input tidak valid                                                             | NULL              | NULL       | NULL          | 
| http://abc.xyz                    | URL standar                                                                   | abc.xyz           | xyz        | abc.xyz       | 
| //user:password@a.b:80/path?query | URL standar dengan skema relatif, port, path dan query, tetapi tanpa sufiks publik | a.b               | NULL       | NULL          | 
| https://[::1]:80                  | URL standar dengan host IPv6                                                  | [::1]             | NULL       | NULL          | 
| http://example.web.china          | URL standar dengan nama domain internasional                                  | example.web.china | china      | web.china     | 
|         www.Example.Co.UK         | URL non-standar dengan spasi, huruf kapital, dan tanpa skema                  | www.Example.Co.UK | Co.UK      | Example.Co.UK | 
| mailto:?to=&subject=&body=        | URI bukan URL--tidak didukung                                                | mailto            | NULL       | NULL          | 
+-----------------------------------+-------------------------------------------------------------------------------+-------------------+------------+---------------+

Fungsi terkait

NET_PUBLIC_SUFFIX adalah fungsi jaringan. Untuk informasi lebih lanjut tentang fungsi jaringan, lihat Fungsi Jaringan.