SYSTEM$GET_PRIVATELINK_CONFIG¶

구문¶

SYSTEM$GET_PRIVATELINK_CONFIG()

인자¶

없습니다.

반환¶

함수는 Snowflake 계정이 있는 클라우드 플랫폼을 기반으로 다음과 같은 이름/값 페어를 포함하는 JSON 오브젝트를 반환합니다.

AWS

{
  "regionless-snowsight-privatelink-url": "<privatelink_org_snowsight_url>",
  "privatelink-account-name": "<account_identifier>",
  "privatelink-connection-ocsp-urls": "<client_redirect_ocsp_url_list>",
  "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>",
  "regionless-privatelink-account-url": "<privatelink_org_account_url>",
  "privatelink-ocsp-url": "<privatelink_ocsp_url>",
  "privatelink-vpce-id": "<aws_vpce_id>",
  "privatelink-account-principal": "<aws_principal_arn>",
  "regionless-privatelink-ocsp-url": "<privatelink_org_ocsp_url>",
  "app-service-privatelink-url": "<privatelink_streamlit_url>",
  "privatelink-dashed-urls-for-duo": "<privatelink_duo_url_list>"
}

Copy

Microsoft Azure

{
  "regionless-snowsight-privatelink-url": "<privatelink_org_snowsight_url>",
  "privatelink-account-name": "<account_identifier>",
  "privatelink-connection-ocsp-urls": "<client_redirect_ocsp_url_list>",
  "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>",
  "regionless-privatelink-account-url": "<privatelink_org_account_url>",
  "privatelink-ocsp-url": "<privatelink_ocsp_url>",
  "privatelink-pls-id": "<azure_privatelink_service_id>",
  "regionless-privatelink-ocsp-url": "<privatelink_org_ocsp_url>",
  "privatelink-dashed-urls-for-duo": "<privatelink_duo_url_list>"
}

Copy

Google Cloud Platform

{
  "regionless-snowsight-privatelink-url": "<privatelink_org_snowsight_url>",
  "privatelink-account-name": "<account_identifier>",
  "privatelink-connection-ocsp-urls": "<client_redirect_ocsp_url_list>",
  "snowsight-privatelink-url": "<privatelink_region_snowsight_url>",
  "privatelink-account-url": "<privatelink_account_url>",
  "privatelink-connection-urls": "<privatelink_connection_url_list>",
  "regionless-privatelink-account-url": "<privatelink_org_account_url>",
  "privatelink-ocsp-url": "<privatelink_ocsp_url>",
  "privatelink-gcp-service-attachment": "<snowflake_service_endpoint>",
  "regionless-privatelink-ocsp-url": "<privatelink_org_ocsp_url>",
  "privatelink-dashed-urls-for-duo": "<privatelink_duo_url_list>"
}

Copy

여기서

regionless-snowsight-privatelink-url

Snowflake 서비스에 비공개 연결을 사용하여 Snowsight에 액세스하기 위한 조직 의 URL입니다.

이 URL을 사용하여 DNS 확인을 위한 정식 이름(즉, CNAME)을 만듭니다. 이 URL은 SYSTEM$ALLOWLIST_PRIVATELINK 함수의 SNOWSIGHT_DEPLOYMENT_REGIONLESS (즉, TYPE)의 출력과 일치해야 합니다.

자세한 내용은 계정 식별자 및 Snowsight: Snowflake 웹 인터페이스 섹션을 참조하십시오.

privatelink-account-name

Snowflake 계정의 식별자입니다.

Snowflake에 연결하기 위한 애플리케이션 및 도구 위해 클라이언트와 함께 이 값을 사용합니다.

자세한 내용은 계정 식별자 섹션을 참조하십시오.

privatelink-connection-ocsp-urls

클라이언트 연결 리디렉션하기 에서 사용할 OCSP URL 목록입니다.

값 목록은 SYSTEM$ALLOWLIST_PRIVATELINK 함수의 OCSP_CLIENT_FAILOVER 출력과 일치해야 합니다.

snowsight-privatelink-url

Snowflake 서비스에 비공개 연결을 사용하여 Snowsight 및 Snowflake Marketplace 에 액세스하기 위한 클라우드 리전 을 포함하는 URL.

이 URL을 사용하여 DNS 확인을 위한 정식 이름(즉, CNAME)을 만듭니다. 이 URL은 SYSTEM$ALLOWLIST_PRIVATELINK 함수의 SNOWSIGHT_DEPLOYMENT (즉, TYPE)의 출력과 일치해야 합니다.

자세한 내용은 계정 식별자 및 Snowsight: Snowflake 웹 인터페이스 섹션을 참조하십시오.

privatelink-internal-stage

AWS PrivateLink 또는 Azure Private Link를 사용하여 Snowflake 내부 스테이지에 연결하기 위한 엔드포인트입니다.

Snowflake 내부 스테이지에 비공개 연결로 이 값을 사용합니다.

쿼리 결과에서 이 키와 해당 값의 가시성은 ENABLE_INTERNAL_STAGES_PRIVATELINK 매개 변수 설정에 따라 다릅니다. 이 매개 변수의 기본 설정은 FALSE 입니다. 쿼리 결과에서 내부 스테이지 엔드포인트를 얻으려면 이 시스템 함수를 실행하기 전에 이 매개 변수를 TRUE 로 설정해야 합니다.

privatelink-account-url

AWS PrivateLink, Azure Private Link 또는 Google Cloud Private Service Connect를 사용하여 Snowflake 계정에 연결하기 위한 URL입니다.

이 값을 사용하여 DNS 확인을 위한 정식 이름(즉, CNAME)을 만듭니다. 이 URL은 SYSTEM$ALLOWLIST_PRIVATELINK 의 출력과 일치해야 합니다.

URL 형식에 대한 자세한 내용은 계정 식별자 를 참조하십시오.

privatelink-connection-urls

클라이언트 리디렉션 에 대한 연결 URL의 목록입니다.

이 URL을 사용하여 DNS 확인을 위한 정식 이름(즉, CNAME)을 만듭니다. 이러한 URL은 SYSTEM$ALLOWLIST_PRIVATELINK 함수의 CLIENT_FAILOVER (즉, TYPE)에 대한 출력과 일치해야 합니다.

regionless-privatelink-account-url

조직 이름과 계정 이름을 포함하는 비공개 연결 URL입니다.

이 값은 SYSTEM$ALLOWLIST_PRIVATELINK 함수의 SNOWFLAKE_DEPLOYMENT_REGIONLESS 출력값과 일치합니다.

privatelink-ocsp-url

AWS PrivateLink, Microsoft Azure Private Link 또는 Google Cloud Private Service Connect를 사용하는 Snowflake 계정 식별자에 해당하는 OCSP URL입니다.

이 값을 사용하여 DNS 확인을 위한 정식 이름(즉, CNAME)을 만듭니다.

privatelink-vpce-id

계정 식별자의 AWS VPCE ID입니다.

이 값을 사용하여 AWS VPC 엔드포인트(즉, VPCE)를 만듭니다.

privatelink-account-principal

VPC 엔드포인트 서비스에 대한 아웃바운드 비공개 연결을 허용하기 위한 AWS 주체 ARN입니다.

이 값을 사용하여 엔드포인트 서비스의 허용된 주체 를 설정하며, 이를 통해 Snowflake가 AWSPrivateLink 를 통해 엔드포인트 서비스에 연결할 수 있습니다.

privatelink-pls-id

별칭 형식으로 된 계정 식별자의 Microsoft Azure Private Link Service ID입니다. 예:

sf-pvlinksvc-azurecentralus.<unique_identifier>.centralus.azure.privatelinkservice

여기서 <unique_identifier> 는 GUID/UUID 형식입니다.

이 값을 사용하여 Azure Private Link 프라이빗 엔드포인트를 만듭니다. 비공개 엔드포인트를 만드는 동안 오류가 발생하면 Snowflake 지원팀 에 문의하여 이 별칭 값과 연결된 리소스 ID를 요청하십시오.

privatelink-gcp-service-attachment

Google Cloud Private Service Connect를 사용할 때 Snowflake 서비스의 엔드포인트입니다.

VPC의 Private Service Connect 엔드포인트를 Snowflake 서비스로 라우팅하는 전달 규칙을 생성할 때 이 값을 사용합니다.

"regionless-privatelink-ocsp-url

계정 식별자 의 OCSP URL입니다.

값은 다음과 같이 기록됩니다.

"ocsp.org_name-account_name.privatelink.snowflakecomputing.com"

여기서

• org_name 은 Snowflake 조직의 이름입니다.

• account_name 은 조직 내 계정의 고유한 이름입니다.

app-service-privatelink-url

AWS PrivateLink를 통해 Streamlit 애플리케이션 트래픽을 라우팅하기 위한 필요한 와일드카드 URL입니다.

privatelink-dashed-urls-for-duo

대시 베리언트 URL 목록은 호스트 이름에 밑줄이 포함된 경우에만 표시됩니다. 이러한 URL은 Duo 다단계 인증에 사용됩니다.

사용법 노트¶

• 계정 관리자(즉, ACCOUNTADMIN 역할이 있는 사용자)만 이 함수를 실행할 수 있습니다.

• Microsoft Azure에서 Snowflake 계정의 경우 함수를 호출하고 쿼리 시간이 1분을 초과하는 경우 Snowflake 지원 에 문의하십시오.

예¶

AWS의 Snowflake 계정에 대한 JSON 정보를 검색합니다.

SELECT SYSTEM$GET_PRIVATELINK_CONFIG();

Copy

선택적으로 다음 명령을 실행하여 JSON 출력을 평면화할 수 있습니다. 다음 출력은 Microsoft Azure의 Snowflake 계정에 대한 예입니다.

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>"               |
|--------------------------------------+--------------------------------------|
| privatelink-connection-ocsp-urls     | "<client_redirect_ocsp_url_list>"    |
|--------------------------------------+--------------------------------------|
| 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>"    |
|--------------------------------------+--------------------------------------|
| regionless-privatelink-account-url   | "<privatelink_org_account_url>"      |
|--------------------------------------+--------------------------------------|
| privatelink-ocsp-url                 | "<privatelink_ocsp_url>"             |
|--------------------------------------+--------------------------------------|
| regionless-privatelink-ocsp-url      | "<privatelink_org_ocsp_url>"         |
+--------------------------------------+--------------------------------------+

Copy