DESCRIBE GATEWAY¶

ゲートウェイのプロパティについて説明します。

DESCRIBE は DESC に短縮できます。

構文¶

DESC[RIBE] GATEWAY <name>

Copy

name

記述するポリシーの識別子を指定します。

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

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

コマンド出力では、次の列にゲートウェイプロパティとメタデータが提供されます。

列	説明
`name`	ゲートウェイ名。
`ingress_url`	GatewayイングレスURL。
`privatelink_ingress_url`	PrivateLinkイングレスURL。
`database_name`	ゲートウェイが作成されるデータベース。
`schema_name`	ゲートウェイが作成されるスキーマ。
`owner`	ゲートウェイを所有するロール。
`owner_role_type`	オブジェクトを所有するロールの型（ROLE または DATABASE_ROLE）。
`spec`	ゲートウェイ仕様（YAML形式）。この列は、コマンドを実行するロールがゲートウェイに対するUSAGE、MODIFY、またはOWNERSHIP権限を持つ場合にのみ表示されます。
`created_on`	ゲートウェイが作成されたときのタイムスタンプ。
`updated_on`	ゲートウェイが最後に更新されたときのタイムスタンプ。
`comment`	ゲートウェイ関連のコメント。

注釈

使用されたロールがゲートウェイに対するUSAGE、MODIFY、またはOWNERSHIP権限を持つ場合、 spec 列が表示されます。そうでないと、他の列は表示されますが、 spec 列は表示されません。

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

権限	オブジェクト	メモ
USAGE 、 MODIFY 、または OWNERSHIP	ゲートウェイ	これらの権限のいずれも、ゲートウェイの説明を許可します。これらの権限を持つロールだけが仕様を表示できます。
USAGE	データベース	ゲートウェイを含むデータベースで必要です。
USAGE	スキーマ	ゲートウェイを含むスキーマで必要です。

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

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

次の例は、 split_gateway という名前のゲートウェイについて記述しています。

DESCRIBE GATEWAY split_gateway;

Copy