ALTER APPLICATION SET SPECIFICATION¶

Snowflake Native App のアプリ仕様を作成または更新します。

注釈

このコマンドは|native-app| でのみ使用できます。

こちらもご参照ください。: ALTER APPLICATION、 ALTER APPLICATION ... { APPROVE | DECLINE} SPECIFICATION、 ALTER APPLICATION DROP SPECIFICATION

構文¶

外部アクセス統合¶

ALTER APPLICATION SET SPECIFICATION <app_spec_name>
  TYPE = EXTERNAL_ACCESS
  LABEL = '<label>'
  DESCRIPTION = '<description>'
  { HOST_PORTS | PRIVATE_HOST_PORTS } = ( '<value>' [, '<value>', ... ] )

セキュリティ統合（CLIENT_CREDENTIALS）¶

ALTER APPLICATION SET SPECIFICATION <app_spec_name>
    TYPE = SECURITY_INTEGRATION
    LABEL = '<string_literal>'
    DESCRIPTION = '<string_literal>'
    OAUTH_TYPE = 'CLIENT_CREDENTIALS'
    OAUTH_TOKEN_ENDPOINT = '<string_literal>'
    OAUTH_ALLOWED_SCOPES = ( '<scope>' [ , '<scope>' ... ] );

セキュリティ統合（AUTHORIZATION_CODE）¶

ALTER APPLICATION SET SPECIFICATION <app_spec_name>
  TYPE = SECURITY_INTEGRATION
  LABEL = '<string_literal>'
  DESCRIPTION = '<string_literal>'
  OAUTH_TYPE = 'AUTHORIZATION_CODE'
  OAUTH_TOKEN_ENDPOINT = '<string_literal>'
  [ OAUTH_AUTHORIZATION_ENDPOINT = '<string_literal>' ]
  [ OAUTH_ALLOWED_SCOPES = ( '<scope>' [ , '<scope>' ... ] ) ];

セキュリティ統合（JWT_BEARER）¶

ALTER APPLICATION SET SPECIFICATION <app_spec_name>
  TYPE = SECURITY_INTEGRATION
  LABEL = '<string_literal>'
  DESCRIPTION = '<string_literal>'
  OAUTH_TYPE = 'JWT_BEARER'
  OAUTH_TOKEN_ENDPOINT = '<string_literal>'
  [ OAUTH_AUTHORIZATION_ENDPOINT = '<string_literal>' ]
  [ OAUTH_ALLOWED_SCOPES = ( '<scope>' [ , '<scope>' ... ] ) ];

リスト¶

ALTER APPLICATION SET SPECIFICATION <app_spec_name>
  TYPE = LISTING
  LABEL = '<string_literal>'
  DESCRIPTION = '<string_literal>'
  TARGET_ACCOUNTS = '<account_list>'
  LISTING = <listing_name>
  [ AUTO_FULFILLMENT_REFRESH_SCHEDULE = '<schedule>' ]

アプリ間通信¶

ALTER APPLICATION SET SPECIFICATION <app_spec_name>
  TYPE = CONNECTION
        LABEL = '<label>'
        DESCRIPTION = '<description>'
        SERVER_APPLICATION = <server_app>
        SERVER_APPLICATION_ROLES = ( <app_role1> [ , <app_role2> ... ] );

一般的なパラメーター¶

app_spec_name

:doc:`アプリ仕様 </developer-guide/native-apps/requesting-app-specs>`の識別子。

TYPE = {EXTERNAL_ACCESS | SECURITY_INTEGRATION | LISTING | CONNECTION}}

アプリ仕様のタイプを指定します。サポートされる値は次のとおりです。

重要

アプリ仕様は、作成後に型を変更することはできません。型を変更しようとすると、エラーになります。

LABEL = 'label'

アプリ仕様のラベルを指定します。このラベルは、コンシューマーに表示されるアプリの仕様名です。各アプリ仕様には、一意のラベルが必要です。

注釈

ラベルのみを変更しても、新しい承認リクエストはトリガーされません。コンシューマーの承認を求めるには、アプリ仕様定義も変更する必要があります（HOST_PORTS、OAUTH_TOKEN_ENDPOINT、または TARGET_ACCOUNTS など）。

DESCRIPTION = 'description'

アプリ仕様の説明を指定します。Snowflakeでは、アプリの仕様タイプと、アプリ仕様がアプリに必要な理由について情報を含めることを推奨しています。

注釈

説明のみを変更しても、新しい承認リクエストはトリガーされません。コンシューマーの承認を求めるには、アプリ仕様定義も変更する必要があります（HOST_PORTS、OAUTH_TOKEN_ENDPOINT、または TARGET_ACCOUNTS など）。

外部アクセス統合パラメーター¶

HOST_PORTS | PRIVATE_HOST_PORTS = ( 'value' [ , 'value', ... ] ): アプリが接続できるホストポートまたはプライベートホストポートのリストを指定します。これらのポートは、外部アクセス統合によって使用されます。

セキュリティ統合パラメーター - CLIENT_CREDENTIALS¶

OAUTH_TYPE = 'CLIENT_CREDENTIALS': 外部のAPI認証に対するセキュリティ統合のタイプを指定します。詳細については、 CREATE SECURITY INTEGRATION （外部 API 認証）をご参照ください。
OAUTH_TOKEN_ENDPOINT = 'string_literal': クライアントが認証付与トークンまたは更新トークンを提示してアクセストークンを取得する際に使用するトークンエンドポイントを指定します。詳細については、 CREATE SECURITY INTEGRATION （外部 API 認証）をご参照ください。
OAUTH_ALLOWED_SCOPES = ( 'scope' [ , 'scope' ... ] ): OAuth クライアント認証情報フロー中に統合に対して USAGE を持つロールによって OAuth からリクエストする際に使用する、各スコープを一重引用符で囲んだスコープのコンマ区切りリストを指定します。詳細については、 CREATE SECURITY INTEGRATION （外部 API 認証）をご参照ください。
OAUTH_ACCESS_TOKEN_VALIDITY = integer: OAuth サーバーによって発行された OAuth アクセストークンのデフォルトの有効期間（秒単位）を指定します。詳細については、 CREATE SECURITY INTEGRATION （外部 API 認証）をご参照ください。

セキュリティ統合パラメーター - AUTHORIZATION_CODE¶

OAUTH_TYPE = 'AUTHORIZATION_CODE': 外部のAPI認証に対するセキュリティ統合のタイプを指定します。詳細については、 CREATE SECURITY INTEGRATION （外部 API 認証）をご参照ください。
OAUTH_TOKEN_ENDPOINT = 'string_literal': クライアントが認証付与トークンまたは更新トークンを提示してアクセストークンを取得する際に使用するトークンエンドポイントを指定します。詳細については、 CREATE SECURITY INTEGRATION （外部 API 認証）をご参照ください。
OAUTH_AUTHORIZATION_ENDPOINT = 'string_literal': 外部サービスへの認証のための URL を指定します。詳細については、 CREATE SECURITY INTEGRATION （外部 API 認証）をご参照ください。
OAUTH_ACCESS_TOKEN_VALIDITY = integer: OAuth サーバーによって発行された OAuth アクセストークンのデフォルトの有効期間（秒単位）を指定します。詳細については、 CREATE SECURITY INTEGRATION （外部 API 認証）をご参照ください。
OAUTH_REFRESH_TOKEN_VALIDITY = integer: OAuthサーバーによって発行されたOAuth更新トークンのデフォルトの有効期間（秒単位）を指定します。詳細については、 CREATE SECURITY INTEGRATION （外部 API 認証）をご参照ください。

セキュリティ統合パラメーター - JWT_BEARER¶

OAUTH_TYPE = 'JWT_BEARER': 外部のAPI認証に対するセキュリティ統合のタイプを指定します。詳細については、 CREATE SECURITY INTEGRATION （外部 API 認証）をご参照ください。
OAUTH_TOKEN_ENDPOINT = 'string_literal': クライアントが認証付与トークンまたは更新トークンを提示してアクセストークンを取得する際に使用するトークンエンドポイントを指定します。詳細については、 CREATE SECURITY INTEGRATION （外部 API 認証）をご参照ください。
OAUTH_AUTHORIZATION_ENDPOINT = 'string_literal': 外部サービスへの認証のための URL を指定します。詳細については、 CREATE SECURITY INTEGRATION （外部 API 認証）をご参照ください。
OAUTH_REFRESH_TOKEN_VALIDITY = integer: OAuthサーバーによって発行されたOAuth更新トークンのデフォルトの有効期間（秒単位）を指定します。詳細については、 CREATE SECURITY INTEGRATION （外部 API 認証）をご参照ください。

リストパラメーター¶

TARGET_ACCOUNTS = 'account_list'

ターゲットアカウントの一重引用符で囲まれた文字列を、コンマ区切りでスペースなしで指定します。各アカウントは OrgName.AccountName の形式で指定する必要があります。たとえば、'ProviderOrg.ProviderAccount,PartnerOrg.PartnerAccount' のように指定します。仕様が承認されると、これらのアカウントがリストに追加されます。拒否されると、すべてのアカウントがリストから削除されます。

LISTING = listing_name

アプリによって作成された外部リストの識別子を指定します。リストはすでに存在し、共有が添付されたアプリによって作成されている必要があります。アプリの仕様でリストが設定された後は、リスト名を変更できません。

AUTO_FULFILLMENT_REFRESH_SCHEDULE = 'schedule'

オプション。クロスリージョンデータ共有のリフレッシュスケジュールを指定します。このパラメーターは、リージョン間でデータを共有する場合に必要です。値は2つの形式で指定できます。

num MINUTE:分を表す数字。最小値10分、最大値11,520分（8日間）。
USING CRON expression time_zone:リフレッシュのためのCron式とタイムゾーン。

アプリ間通信パラメーター¶

SERVER_APPLICATION = server_app

接続先のサーバーアプリケーションの名前。以下の操作はサポートされていません。

既存の仕様のこの設定を更新します。
同じサーバーアプリケーションを対象とする複数の仕様。

SERVER_APPLICATION_ROLES = ( app_role1 [ , app_role2 ... ] )

このアプリケーションに付与するサーバーアプリケーション内のアプリケーションロールのコンマ区切りリストを指定します。

使用上の注意¶

このコマンドを使用するには、プロバイダーは :code:`manifest_version: 2`を使用しているアプリのマニフェストファイルを確認する必要があります。

例¶

外部アクセス用のアプリ仕様を作成します。

ALTER APPLICATION SET SPECIFICATION eai_spec
  TYPE = EXTERNAL_ACCESS
  LABEL = 'External API Access'
  DESCRIPTION = 'Connect to external weather API'
  HOST_PORTS = ('api.weather.com:443', 'api.openweather.org:443');

OAuth セキュリティ統合用のアプリ仕様を作成します。

ALTER APPLICATION SET SPECIFICATION oauth_spec
  TYPE = SECURITY_INTEGRATION
  LABEL = 'OAuth Integration'
  DESCRIPTION = 'Connect to Microsoft Graph API'
  OAUTH_TYPE = 'CLIENT_CREDENTIALS'
  OAUTH_TOKEN_ENDPOINT = 'https://login.microsoftonline.com/YOUR_TENANT_ID/oauth2/v2.0/token'
  OAUTH_ALLOWED_SCOPES = ('https://graph.microsoft.com/.default');

リストを介したデータ共有用のアプリ仕様を作成します。

ALTER APPLICATION SET SPECIFICATION shareback_spec
  TYPE = LISTING
  LABEL = 'Telemetry Data Sharing'
  DESCRIPTION = 'Share telemetry and usage data with provider'
  TARGET_ACCOUNTS = 'ProviderOrg.ProviderAccount,PartnerOrg.PartnerAccount'
  LISTING = telemetry_listing
  AUTO_FULFILLMENT_REFRESH_SCHEDULE = '720 MINUTE';

ALTER APPLICATION SET SPECIFICATION¶

構文¶

外部アクセス統合¶

セキュリティ統合（CLIENT_CREDENTIALS）¶

セキュリティ統合（AUTHORIZATION_CODE）¶

セキュリティ統合（JWT_BEARER）¶

リスト¶

アプリ間通信¶

一般的なパラメーター¶

外部アクセス統合パラメーター¶

セキュリティ統合パラメーター - CLIENT_CREDENTIALS¶

セキュリティ統合パラメーター - AUTHORIZATION_CODE¶

セキュリティ統合パラメーター - JWT_BEARER¶

リスト パラメーター¶

アプリ間通信パラメーター¶

使用上の注意¶

例¶

リストパラメーター¶