SYSTEM$GET_PRIVATELINK¶

구문¶

AWS:

SYSTEM$GET_PRIVATELINK( '<aws_id>' , '<federated_token>' )

Copy

Azure:

SYSTEM$GET_PRIVATELINK( '<private-endpoint-resource-id>' , '<federated_token>' )

Copy

GCP

SYSTEM$GET_PRIVATELINK( '<gcp_project_id>' , '<access_token>' )

Copy

인자¶

'aws_id'

AWS(Amazon Web Services) 계정을 문자열로 고유하게 식별하는 12자리 식별자입니다.

'private-endpoint-resource-id'

Microsoft Azure의 프라이빗 엔드포인트를 문자열로 고유하게 식별하는 식별자입니다.

'federated_token'

페더레이션 사용자에 대한 액세스 자격 증명을 문자열로 포함하는 페더레이션 토큰 값입니다.

이 값을 얻으려면 Snowflake 계정을 호스팅하는 클라우드 플랫폼에 알맞은 명령을 실행하십시오. 플랫폼에서 제공하는 명령줄 도구를 사용합니다.

• AWS의 Snowflake:

  aws sts get-federation-token --name sam
  

  Copy

• Azure의 Snowflake:

  az account get-access-token --subscription <SubscriptionID>
  

  Copy

  여기서:

  • SubscriptionID

    구독의 고유 식별자입니다. 예:

    13c...

    이 값을 얻으려면 명령줄 환경에서 다음 Azure CLI 명령을 실행하십시오.

    az account list --output table
    

    Copy

    이 예에서는 잘린 SubscriptionID 열의 출력값을 확인합니다.

    Name     CloudName   SubscriptionId                        State    IsDefault
    -------  ----------  ------------------------------------  -------  ----------
    MyCloud  AzureCloud  13c...                                Enabled  True
    

    Copy

'gcp_project_id'

Google Cloud(GCP) 프로젝트를 고유하게 식별하는 식별자로, 문자열입니다.

'access_token'

Google Cloud 사용자에 대한 액세스 자격 증명을 문자열로 포함하는 액세스 토큰 값입니다.

사용법 노트¶

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

• 이 함수는 AWS 또는 Azure의 Snowflake 계정과 함께 사용할 수 있습니다. GCP(Google Cloud Platform)은 현재 지원되지 않습니다.

• SYSTEM$AUTHORIZE_PRIVATELINK 함수를 호출하여 Snowflake 계정을 활성화해 Snowflake 서비스에 대한 비공개 연결을 사용합니다.

• SYSTEM$REVOKE_PRIVATELINK 함수를 호출하여 Snowflake 계정을 비활성화해 Snowflake 서비스에 대한 비공개 연결을 사용합니다.

예¶

AWS의 Snowflake 계정에 대해 AWS PrivateLink가 인증되었는지 확인합니다. 이 예에서는 값이 잘립니다.

USE ROLE ACCOUNTADMIN;

select SYSTEM$GET_PRIVATELINK(
    '185...',
    '{
      "Credentials": {
          "AccessKeyId": "ASI...",
          "SecretAccessKey": "enw...",
          "SessionToken": "Fwo...",
          "Expiration": "2021-01-07T19:06:23+00:00"
      },
      "FederatedUser": {
          "FederatedUserId": "185...:sam",
          "Arn": "arn:aws:sts::185...:federated-user/sam"
      },
      "PackedPolicySize": 0
  }'
  );

Copy

Azure의 Snowflake 계정에 대해 Azure Private Link가 인증되었는지 확인합니다. 이 예에서는 값이 잘립니다.

USE ROLE ACCOUNTADMIN;

select SYSTEM$GET_PRIVATELINK(
  '/subscriptions/26d.../resourcegroups/sf-1/providers/microsoft.network/privateendpoints/test-self-service',
  'eyJ...');

Copy

GCP 에서 Snowflake 계정에 대해 Google Cloud Private Service Connect가 승인되었는지 확인하십시오.

USE ROLE ACCOUNTADMIN;

select SYSTEM$GET_PRIVATELINK(
  'my-gcp-project-id',
  'ya29.a0AcM612zT4pJaXdYfwgY8aiMoDE9W_xkqQ20coFTB1TJcImKDPo...'
  );

Copy