SYSTEM$AUTHORIZE_PRIVATELINK¶

構文¶

AWS:

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

Copy

Azure:

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

Copy

引数¶

'aws_id'

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

'private-endpoint-resource-id'

Microsoft Azure（Azure）のSnowflakeアカウントを文字列として一意に識別する識別子。

'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

使用上の注意¶

• アカウント管理者（つまり、ACCOUNTADMIN ロールを持つユーザー）のみがこの関数を実行できます。

• この関数は、 AWS またはAzureのSnowflakeアカウントで使用できます。Google Cloud Platform（GCP）は現在サポートされていません。

• SYSTEM$GET_PRIVATELINK 関数を呼び出して、SnowflakeアカウントがSnowflakeサービスへのプライベート接続の使用を承認されているかどうかを確認します。

• SYSTEM$REVOKE_PRIVATELINK 関数を呼び出して、Snowflakeアカウントを無効にし、Snowflakeサービスへのプライベート接続を使用します。

例¶

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

use role accountadmin;

select SYSTEM$AUTHORIZE_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$AUTHORIZE_PRIVATELINK(
  '/subscriptions/26d.../resourcegroups/sf-1/providers/microsoft.network/privateendpoints/test-self-service',
  'eyJ...');

Copy