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

SYSTEM$RESTORE_PRIVATELINK_ENDPOINT¶

Snowflake VPC または VNet のプライベート接続エンドポイントを復元して、プライベート接続を使用して Snowflake が外部サービスに接続できるようにします。エンドポイントは、Snowflakeアカウントをホストするクラウドプラットフォームに応じて、サービスエンドポイントまたはリソースエンドポイントになります。

プライベートエンドポイントは、デプロビジョニングしてから7日以内であれば復元できます。7日が経過すると、エンドポイントは復元できなくなるため、 SYSTEM$PROVISION_PRIVATELINK_ENDPOINT システム関数を使用してエンドポイントを再作成する必要があります。

構文¶

AWS:

SYSTEM$RESTORE_PRIVATELINK_ENDPOINT( '<provider_service_name>' )

Copy

Azure:

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

Copy

引数¶

provider_service_name: 復元する外部サービスまたはリソースのエンドポイントを指定します。たとえば、Amazon API Gatewayの場合は com.amazonaws.us-west-2.execute-api、Amazon S3の場合は com.amazonaws.us-west-2.s3 です。

'provider_resource_id'

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

'subresource'

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

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

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

戻り値¶

識別子を持つエンドポイントが正常に復元されたことを示すステータスメッセージを返します。

失敗した場合はエラーを返します。たとえば、指定された引数が有効な既存のエンドポイントではない場合です。エンドポイント名がわからない場合は、 SYSTEM$GET_PRIVATELINK_ENDPOINTS_INFO システム関数を使用して、Snowflakeアカウント内のすべてのエンドポイントをリストできます。

使用上の注意¶

アカウント管理者（ACCOUNTADMIN ロールを持つユーザー）のみが、この関数を呼び出すことができます。
指定した引数にプライベート接続エンドポイントが関連付けられていない場合、エラーメッセージが表示されます。

例¶

AWS:

Amazon S3への外部アクセスを持つプライベートエンドポイントを復元します。

SELECT SYSTEM$RESTORE_PRIVATELINK_ENDPOINT('com.amazonaws.us-west-2.s3');

Copy

Azure:

プライベートエンドポイントを復元して、Microsoft Azure上のSnowflakeがAzure VNet のAzure API 管理サービスに接続できるようにします。
SELECT SYSTEM$RESTORE_PRIVATELINK_ENDPOINT(
  '/subscriptions/11111111-2222-3333-4444-5555555555/resourceGroups/my_rg/providers/Microsoft.Sql/servers/my_db_server',
  'sqlServer'
);
Copy
Private endpoint with id ''/subscriptions/66666666-7777-8888-9999-0000000000/resourcegroups/rg/providers/microsoft.network/privateendpoints/00000000-1111-2222-3333-4444444444'' restored successfully.