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

SYSTEM$SET_PRIVATELINK_ENDPOINT_HOSTNAME¶

注釈

SnowflakeアカウントがAzure政府リージョンにある場合、プロバイダーリソース ID は、政府サブスクリプション内のリソースの ID にする必要があります。Snowflake顧客向けの政府リージョンに関する詳細情報については、米国SnowGov リージョンをご参照ください。

構文¶

AWS:

SYSTEM$SET_PRIVATELINK_ENDPOINT_HOSTNAME( '<provider_service_name>' , '<host_name>' )

Azure:

SYSTEM$SET_PRIVATELINK_ENDPOINT_HOSTNAME( '<provider_resource_id>' , '<host_name>' , [ , '<subresource>' ] )

Google Cloud:

SYSTEM$SET_PRIVATELINK_ENDPOINT_HOSTNAME( '<target_service_id>' , '<host_name>' )

引数¶

AWS:

'provider_service_name'

接続する外部サービスまたはリソースを指定します。たとえば、Amazon API Gatewayの場合は com.amazonaws.us-west-2.execute-api、Amazon S3の場合は com.amazonaws.us-west-2.s3 です。

この値を AWS から取得する情報については、プライベート接続エンドポイントのプロビジョニングをご参照ください。

'host_name'

VPC または VNet のリソースにアクセスするために使用する新しい完全修飾ホスト名を指定します。

この値にはポート番号は含まれず、外部サービスへの接続に使用するSnowflakeオブジェクトで指定したものと一致する必要があります。

たとえば、 bedrock-runtime.us-west-2.amazonaws.com や *.s3.us-west-2.amazonaws.com です。

外部ステージおよび外部ボリュームにプライベート接続を使用する場合、host_name には、AWS S3バケットを指定する代わりにワイルドカードを使用する必要があります。

この値を AWS から取得する情報については、プライベート接続エンドポイントのプロビジョニングをご参照ください。

Azure:

'provider_resource_id'

VPC または VNet でリソースの完全修飾識別子を指定します。

'host_name'

VPC または VNet でリソースにアクセスするための新しい完全修飾ホスト名を指定します。

外部関数のアウトバウンドプライベート接続のホスト名の例については、以下のトピックをご参照ください。

'subresource'

Azureリソースのサブリソース名を指定します。

この引数は、Azure Private Link Service およびAzure API Management Serviceでは必要ありません。

サポートされているすべての値については、サブリソースの表をご参照ください。

Google Cloud:

'target_service_id': 接続先として、カスタムサービスへのサービスアタッチメント ID、またはリージョン単位のGoogle API エンドポイントを指定します。
'host_name': リソースにアクセスするための新しい完全修飾ホスト名を指定します。

戻り値¶

プライベート接続エンドポイントのホスト名が正常に更新されたことを示すステータスメッセージを返します。

アクセス制御の要件¶

アカウント管理者（ACCOUNTADMIN ロールを持つユーザー）のみが、この関数を呼び出すことができます。

使用上の注意¶

既存のプライベート接続エンドポイントのホスト名のみを変更できます。

例¶

AWS:

プライベートエンドポイントのホスト名を更新して、Amazon Web Services 上のSnowflakeが Amazon Web Services VPC 内の VPCE サービスに接続できるようにします。

SELECT SYSTEM$SET_PRIVATELINK_ENDPOINT_HOSTNAME(
  'com.amazonaws.vpce.us-west-2.vpce-svc-01234567890abcdef',
  'my-new-service-name.com'
  );

Successfully set the host name of the privatelink endpoint ``com.amazonaws.vpce.us-west-2.vpce-svc-01234567890abcdef`` to ``my-new-service-name.com``

Azure:

プライベートエンドポイントのホスト名を更新して、Microsoft Azure 上のSnowflakeが Microsoft Azure VNet 内の Microsoft Azure API 管理サービスに接続できるようにします。

SELECT SYSTEM$SET_PRIVATELINK_ENDPOINT_HOSTNAME(
  '/subscriptions/f4b00c5f-f6bf-41d6-806b-e1cac4f1f36f/resourceGroups/aztest1-external-function-rg/providers/Microsoft.ApiManagement/service/aztest1-external-function-api',
  'my-new-custom-api-endpoint.net',
  'Gateway'
  );

Successfully set the host name of the privatelink endpoint ``/subscriptions/f4b00c5f-f6bf-41d6-806b-e1cac4f1f36f/resourceGroups/aztest1-external-function-rg/providers/Microsoft.ApiManagement/service/aztest1-external-function-api`` to ``my-new-custom-api-endpoint.net``

Google Cloud:

プライベートエンドポイントのホスト名を更新して、Google Cloud Platform 上のSnowflakeが Google Cloud Platform VPC ネットワーク内のサービスアタッチメントに接続できるようにします。

SELECT SYSTEM$SET_PRIVATELINK_ENDPOINT_HOSTNAME(
  'projects/my-project/regions/us-west2/serviceAttachments/my-http-server',
  'my-new-custom-api-endpoint.com'
  );

Successfully set the host name of the privatelink endpoint ``projects/my-project/regions/us-west2/serviceAttachments/my-http-server`` to ``my-new-custom-api-endpoint.com``