カテゴリ：: システム関数（システム制御）

SYSTEM$REVOKE_PRIVATELINK¶

現在のアカウントに対するSnowflakeサービスへのプライベート接続を無効にします。

こちらもご参照ください。: SYSTEM$AUTHORIZE_PRIVATELINK、 SYSTEM$GET_PRIVATELINK、 SYSTEM$GET_PRIVATELINK_AUTHORIZED_ENDPOINTS

構文¶

AWS:

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

Azure:

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

GCP

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

引数¶

'aws_id'

Amazon Web Services（AWS）アカウントを文字列として一意に識別する12桁の識別子。

'private-endpoint-resource-id'

Microsoft Azure（Azure）のプライベートエンドポイントを文字列として一意に識別する識別子。

'federated_token'

フェデレーションユーザーのアクセス認証情報を文字列として含むフェデレーショントークン値。

この値を取得するには、Snowflakeアカウントをホストするクラウドプラットフォームに対して適切なコマンドを実行します。プラットフォームが提供するコマンドラインツールを使用します。

AWS 上のSnowflakeの場合、
```
aws sts get-federation-token --name sam
```
Azure上のSnowflakeの場合、
```
az account get-access-token --subscription <SubscriptionID>
```
条件:
- SubscriptionID
  サブスクリプションの一意の識別子。例:
  
  13c...
  
  To obtain this value, execute the following Azure CLI command in your command-line environment:
  az account list --output table
  
  この例では切り捨てられている SubscriptionID 列の出力値に注意してください。
  
  Name CloudName SubscriptionId State IsDefault ------- ---------- ------------------------------------ ------- ---------- MyCloud AzureCloud 13c... Enabled True

'gcp_project_id'

Google Cloud（GCP）プロジェクトを文字列として一意に識別する識別子。

'access_token'

Google Cloudユーザーのアクセス認証情報を文字列として含むアクセストークン値。

使用上の注意¶

アカウント管理者（つまり、ACCOUNTADMIN ロールを持つユーザー）のみがこの関数を実行できます。
この関数は、 AWS またはAzureのSnowflakeアカウントで使用できます。Google Cloud Platform（GCP）は現在サポートされていません。
SYSTEM$GET_PRIVATELINK 関数を呼び出して、SnowflakeアカウントがSnowflakeサービスへのプライベート接続の使用を承認されているかどうかを確認します。
SYSTEM$AUTHORIZE_PRIVATELINK 関数を呼び出して、SnowflakeアカウントがSnowflakeサービスへのプライベート接続を使用できるようにします。

例¶

AWS のSnowflakeアカウントの AWS PrivateLink を無効にします。この例では、値が切り捨てられていることに注意してください。

USE ROLE ACCOUNTADMIN;

select SYSTEM$REVOKE_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
  }'
  );

AzureのSnowflakeアカウントのAzure Private Linkを無効にします。この例では、値が切り捨てられていることに注意してください。

USE ROLE ACCOUNTADMIN;

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

GCP でSnowflakeアカウントのGoogle Cloud Private Service Connectを無効にします。

USE ROLE ACCOUNTADMIN;

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