ALTER GATEWAY¶

既存のゲートウェイの構成を変更します。このコマンドを使用して、ゲートウェイのトラフィック分割構成を更新します。

こちらもご参照ください。: CREATE GATEWAY、 DESCRIBE GATEWAY、 DROP GATEWAY、 SHOW GATEWAYS

構文¶

ALTER GATEWAY [ IF EXISTS ] <name>
  FROM SPECIFICATION <specification_text>

Copy

パラメーター¶

name

変更するゲートウェイの識別子を指定します。

識別子にスペースまたは特殊文字が含まれる場合は、文字列全体を二重引用符で囲む必要があります。二重引用符で囲まれた識別子も大文字と小文字が区別されます。

詳細については、識別子の要件をご参照ください。

FROM SPECIFICATION

更新されたゲートウェイ仕様をインラインで指定します。仕様は、トラフィック分割構成を定義します。

仕様では、次の形式を使用します。

spec:
  type: traffic_split
  split_type: custom
  targets:
  - type: endpoint
    value: <db>.<schema>.<service>!<endpoint>
    weight: <weight>
  - type: endpoint
    value: <db>.<schema>.<service>!<endpoint>
    weight: <weight>

Copy

仕様パラメーター¶

type

固定値。traffic_split に設定する必要があります。

split_type

固定値。custom に設定する必要があります。

targets

トラフィックをルーティングするターゲットエンドポイントのリスト。各ターゲットは以下を指定する必要があります。

type: 固定値。endpoint に設定する必要があります。
value: db.schema.service!endpoint 形式の完全修飾エンドポイント名。各ターゲットエンドポイントが存在する必要があります。
weight: このエンドポイントのトラフィックの重み。整数として指定されます。すべての重みの合計は100である必要があります。

注釈

ゲートウェイあたりのエンドポイントの最大数は、デフォルトで5です。

アクセス制御の要件¶

この操作の実行に使用されるロールには、少なくとも次の権限が必要です。

権限	オブジェクト	メモ
MODIFY または OWNERSHIP	ゲートウェイ	ゲートウェイの構成を変更するために必要です。
BIND SERVICE ENDPOINT	アカウント	サービスエンドポイントをゲートウェイにバインドするために必要です。
USAGE	データベース	ゲートウェイを含むデータベースで必要です。
USAGE	スキーマ	ゲートウェイを含むスキーマで必要です。
USAGE	サービスエンドポイント	ターゲットサービスエンドポイントで必要です。

必要な権限を付与するには、次のコマンドを使用します。

-- Grant MODIFY or OWNERSHIP privilege on the gateway
GRANT MODIFY ON GATEWAY <gateway_name> TO ROLE <role_name>;
-- OR
GRANT OWNERSHIP ON GATEWAY <gateway_name> TO ROLE <role_name>;

-- Grant BIND SERVICE ENDPOINT privilege on the account
GRANT BIND SERVICE ENDPOINT ON ACCOUNT TO ROLE <role_name>;

Copy

指定された権限のセットを使用してカスタムロールを作成する手順については、カスタムロールの作成をご参照ください。

セキュリティ保護可能なオブジェクトに対して SQL アクションを実行するためのロールと権限付与に関する一般的な情報については、アクセス制御の概要をご参照ください。

使用上の注意¶

メタデータについて:

注意

Snowflakeサービスを使用する場合、お客様は、個人データ（ユーザーオブジェクト向け以外）、機密データ、輸出管理データ、またはその他の規制されたデータがメタデータとして入力されていないことを確認する必要があります。詳細については、 Snowflakeのメタデータフィールドをご参照ください。

例¶

ゲートウェイを変更して、トラフィック分割構成を更新します。

ALTER GATEWAY split_gateway
  FROM SPECIFICATION $$
spec:
  type: traffic_split
  split_type: custom
  targets:
  - type: endpoint
    value: db.schema.s2!ep1
    weight: 60
  - type: endpoint
    value: db.schema.s1!ep1
    weight: 40
$$;

Copy