Categories:: 시스템 함수 (System Control)

SYSTEM$UNREGISTER_PRIVATELINK_ENDPOINT¶

비공개 연결 엔드포인트를 등록 해제하여 연결을 Snowflake 서비스로 라우팅합니다.

구문¶

AWS

SYSTEM$UNREGISTER_PRIVATELINK_ENDPOINT(
  '<aws_private_endpoint_vpce_id>',
  '<aws_account_id>',
  '<token>'
  )

Copy

Azure

SYSTEM$UNREGISTER_PRIVATELINK_ENDPOINT(
  '<azure_private_endpoint_link_id>',
  '<azure_private_endpoint_resource_id>',
  '<token>'
  )

Copy

인자¶

AWS

aws_private_endpoint_vpce_id

Amazon Web Services(AWS) 가상 프라이빗 클라우드 엔드포인트(AWS VPCEID)의 식별자를 지정합니다.

AWS VPCEID 값을 얻으려면 AWS 콘솔로 이동하거나 다음 명령을 사용합니다.

aws ec2 describe-vpc-endpoints

Copy

aws_account_id

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

AWS 계정 ID 값을 얻으려면 AWS 콘솔을 탐색하거나 다음 명령을 사용합니다.

aws sts get-caller-identity

Copy

Azure

azure_private_endpoint_link_id

Microsoft Azure(Azure) 가상 프라이빗 클라우드 엔드포인트 링크(Azure LinkID)의 식별자를 지정합니다.

Azure LinkID 값을 얻으려면:

SYSTEM$GET_PRIVATELINK_AUTHORIZED_ENDPOINTS 시스템 함수를 실행합니다.

azure_private_endpoint_resource_id

Microsoft Azure의 Snowflake 계정을 문자열로 고유하게 식별하는 식별자입니다.

Azure 비공개 엔드포인트 리소스 ID를 가져오려면 다음 명령을 사용하십시오.

az network private-endpoint list --resource-group my_resource_group

Copy

token

비공개 연결 엔드포인트의 소유권을 확인하기 위한 엑세스 토큰을 지정합니다.

토큰을 받으려면 최소한 비공개 연결 엔드포인트에 대해 해당 읽기 또는 설명 권한이 있어야 합니다. 자세한 내용은 다음을 참조하십시오.

토큰을 받으려면 다음 명령을 사용하십시오.

AWS의 Snowflake:

aws sts get-federation-token --name snowflake --policy '{ "Version": "2012-10-17", "Statement"
: [ { "Effect": "Allow", "Action": ["ec2:DescribeVpcEndpoints"], "Resource": ["*"] } ] }'

Copy

Azure의 Snowflake:

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

Copy

엑세스 토큰의 범위를 제한하는 방법에 대한 자세한 내용은 다음을 참조하십시오.

AWS의 Snowflake: Amazon Web Services 에서 엑세스 토큰 범위 관리하기
Azure의 Snowflake: Microsoft Azure 에서 엑세스 토큰 범위 관리하기

반환¶

비공개 연결 엔드포인트의 등록에 대한 상태 메시지를 반환합니다.

사용법 노트¶

계정 관리자(ACCOUNTADMIN 역할이 있는 사용자)만 이 함수를 호출할 수 있습니다.

예¶

Snowflake 계정에 대한 VPC 엔드포인트 등록을 취소합니다. AccessKeyId, SecretAccessKey, SessionToken 값은 잘립니다.

AWS

SELECT SYSTEM$UNREGISTER_PRIVATELINK_ENDPOINT(
  'vpce-0c1...',
  '174...',
  '{
    "Credentials": {
      "AccessKeyId": "ASI...",
      "SecretAccessKey": "aFP...",
      "SessionToken": "Fwo...",
      "Expiration": "2024-04-26 05:49:09+00:00"
    },
    "FederatedUser": {
      "FederatedUserId": "0123...:snowflake",
      "Arn": "arn:aws:sts::174...:federated-user/sam"
    },
    "PackedPolicySize": 9
  }'
);

Copy

Azure

SELECT SYSTEM$UNREGISTER_PRIVATELINK_ENDPOINT(
  '123...',
  '/subscriptions/0cc51670-.../resourceGroups/dbsec_test_rg/providers/Microsoft.Network/
  privateEndpoints/...',
  'eyJ...'
  );

Copy