Kategorien:: Systemfunktionen (Systeminformationen)

SYSTEM$GET_PRIVATELINK_CONFIG¶

Gibt eine JSON-Darstellung der Snowflake-Kontoinformationen zurück, die zur Vereinfachung der Self-Service-Konfiguration der privaten Konnektivität zum Snowflake-Dienst oder zu den internen Stagingbereichen erforderlich sind.

Syntax¶

SYSTEM$GET_PRIVATELINK_CONFIG()

Argumente¶

Keine.

Nutzungshinweise¶

Nur Kontoadministratoren (d. h. Benutzer mit der Rolle ACCOUNTADMIN) können diese Funktion ausführen.

Ausgabe¶

Die Funktion gibt ein JSON-Objekt zurück, das auf Basis der Cloudplattform, auf der sich Ihr Snowflake-Konto befindet, die folgenden Name/Wert-Paare enthält:

AWS

{
  "regionless-snowsight-privatelink-url": "<privatelink_org_snowsight_url>",
  "privatelink-account-name": "<account_identifier>",
  "snowsight-privatelink-url": "<privatelink_region_snowsight_url>",
  "privatelink-internal-stage": "<privatelink_stage_endpoint>",
  "privatelink-account-url": "<privatelink_account_url>",
  "privatelink-connection-urls": "<privatelink_connection_url_list>"
  "privatelink-ocsp-url": "<privatelink_ocsp_url>",
  "privatelink-vpce-id": "<aws_vpce_id>"
}

Microsoft Azure

{
  "regionless-snowsight-privatelink-url": "<privatelink_org_snowsight_url>",
  "privatelink-account-name": "<account_identifier>",
  "snowsight-privatelink-url": "<privatelink_region_snowsight_url>",
  "privatelink-internal-stage": "<privatelink_stage_endpoint>",
  "privatelink-account-url":"<privatelink_account_url>",
  "privatelink-connection-urls": "<privatelink_connection_url_list>"
  "privatelink-ocsp-url": "<privatelink_ocsp_url>",
  "privatelink-pls-id": "<azure_privatelink_service_id>"
}

Google Cloud Platform

{
  "regionless-snowsight-privatelink-url": "<privatelink_org_snowsight_url>",
  "privatelink-account-name": "<account_identifier>",
  "snowsight-privatelink-url": "<privatelink_region_snowsight_url>",
  "privatelink-account-url": "<privatelink_account_url>",
  "privatelink-connection-urls": "<privatelink_connection_url_list>"
  "privatelink-ocsp-url": "<privatelink_ocsp_url>",
  "privatelink-gcp-service-attachment": "<snowflake_service_endpoint>"
}

Wobei:

regionless-snowsight-privatelink-url
Die URL Ihrer Organisation für den Zugang zu Snowsight mit Private Konnektivität zum Snowflake-Dienst.

Verwenden Sie diese URL, um einen kanonischen Namen (d. h. CNAME) für die DNS-Auflösung zu erstellen. Diese URL muss mit der Ausgabe für SNOWSIGHT_DEPLOYMENT_REGIONLESS (d. h. TYPE) der Funktion SYSTEM$ALLOWLIST_PRIVATELINK übereinstimmen.

Weitere Informationen dazu finden Sie unter Kontobezeichner und Snowsight: Die Snowflake-Weboberfläche.

privatelink-account-name
Der Bezeichner Ihres Snowflake-Kontos.

Verwenden Sie diesen Wert mit Clients für Verbinden mit Snowflake.

Weitere Informationen dazu finden Sie unter Kontobezeichner.

snowsight-privatelink-url
Die URL, die die Cloudregion für den Zugang zu Snowsight und Snowflake Marketplace mit Private Konnektivität zum Snowflake-Dienst enthält.

Verwenden Sie diese URL, um einen kanonischen Namen (d. h. CNAME) für die DNS-Auflösung zu erstellen. Diese URL muss mit der Ausgabe für SNOWSIGHT_DEPLOYMENT (d. h. TYPE) der Funktion SYSTEM$ALLOWLIST_PRIVATELINK übereinstimmen.

Weitere Informationen dazu finden Sie unter Kontobezeichner und Snowsight: Die Snowflake-Weboberfläche.

privatelink-internal-stage
Der Endpunkt für die Verbindung zu Ihrem internen Snowflake-Stagingbereich über Azure Private Link oder AWS PrivateLink.

Verwenden Sie diesen Wert mit Private Konnektivität zu internen Snowflake-Stagingbereichen.

Die Sichtbarkeit dieses Schlüssels und des entsprechenden Wertes im Abfrageergebnis hängt von der Einstellung des Parameters ENABLE_INTERNAL_STAGES_PRIVATELINK ab. Die Standardeinstellung für diesen Parameter ist FALSE. Sie müssen diesen Parameter auf TRUE setzen, bevor Sie diese Systemfunktion ausführen, um den Endpunkt des internen Stagingbereichs im Abfrageergebnis zu erhalten.

privatelink-account-url
Die URL zur Verbindung mit Ihrem Snowflake-Konto über AWS PrivateLink, Azure Private Link oder Google Cloud Private Service Connect.

Verwenden Sie diesen Wert, um einen kanonischen Namen (d. h. CNAME) für die DNS-Auflösung zu erstellen. Diese URL sollte mit der Ausgabe von SYSTEM$ALLOWLIST_PRIVATELINK übereinstimmen.

Weitere Informationen zu URL-Formaten finden Sie unter Kontobezeichner.

privatelink-connection-urls
Die Liste der Verbindungs-URLs für die Clientumleitung.

Verwenden Sie diese URLs, um einen kanonischen Namen (d. h. CNAME) für die DNS-Auflösung zu erstellen. Diese URL muss mit der Ausgabe für CLIENT_FAILOVER (d. h. TYPE) der Funktion SYSTEM$ALLOWLIST_PRIVATELINK übereinstimmen.

privatelink-ocsp-url
Die OCSP-URL, die dem Kontobezeichner Ihres Snowflake-Kontos entspricht, das AWS PrivateLink, Microsoft Azure Private Link oder Google Cloud Private Service Connect verwendet.

Verwenden Sie diesen Wert, um einen kanonischen Namen (d. h. CNAME) für die DNS-Auflösung zu erstellen.

privatelink-vpce-id
Die AWS-VPCE-ID Ihres Kontobezeichners.

Verwenden Sie diesen Wert, um einen AWS-VPC-Endpunkt (d. h. VPCE) zu erstellen.

privatelink-pls-id
Die Microsoft Azure Private Link-Dienst-ID Ihres Kontobezeichners.

Verwenden Sie diesen Wert, um einen privaten Azure Private Link-Endpunkt zu erstellen.

privatelink-gcp-service-attachment
Der Endpunkt für den Snowflake-Dienst bei Verwendung von Google Cloud Private Service Connect.

Verwenden Sie diesen Wert beim Erstellen einer Weiterleitungsregel, um den Private Service Connect-Endpunkt in Ihrer VPC an den Snowflake-Dienst weiterzuleiten.

Beispiele¶

Rufen Sie die JSON-Informationen für Ihr Snowflake-Konto auf AWS ab:

SELECT SYSTEM$GET_PRIVATELINK_CONFIG();

Sie können optional den folgenden Befehl ausführen, um die JSON-Ausgabe zu vereinfachen. Die folgende Ausgabe ist ein Beispiel für ein Snowflake-Konto auf Microsoft Azure:

select key, value from table(flatten(input=>parse_json(SYSTEM$GET_PRIVATELINK_CONFIG())));

+-----------------------------------------------------------------------------+
| KEY                                  | VALUE                                |
+-----------------------------------------------------------------------------+
| regionless-snowsight-privatelink-url | "<privatelink_org_snowsight_url>"    |
|--------------------------------------|--------------------------------------|
| privatelink-account-name             | "<account_identifier>"               |
|--------------------------------------|--------------------------------------|
| snowsight-privatelink-url            | "<privatelink_region_snowsight_url>" |
|--------------------------------------|--------------------------------------|
| privatelink-internal-stage           | "<privatelink_stage_endpoint>"       |
|--------------------------------------|--------------------------------------|
| privatelink-account-url              | "<privatelink_account_url>"          |
|--------------------------------------|--------------------------------------|
| privatelink-connection-urls          | "<privatelink_connection_url_list>"  |
|--------------------------------------|--------------------------------------|
| privatelink-pls-id                   | "<azure_private_link_service_id>"    |
|--------------------------------------|--------------------------------------|
| privatelink-ocsp-url                 | "<privatelink_ocsp_url>"             |
+--------------------------------------|--------------------------------------+