SHOW に OFFERS¶

リストに追加されたすべてのオファーについての情報を提供します。

構文¶

SHOW OFFERS [ LIKE '<pattern>' ] IN LISTING <listing>

Copy

パラメーター¶

LIKE 'pattern'

オプションで、オブジェクト名でコマンド出力をフィルタリングします。フィルターは、 SQL ワイルドカード文字（% および _）をサポートする、大文字と小文字を区別しないパターンマッチングを使用します。

たとえば、次のパターンは同じ結果を返します。

... LIKE '%testing%' ...

... LIKE '%TESTING%' ...

. デフォルト: 値なし（フィルタリングは出力に非適用）。

IN LISTING listing: 表示したいオファーに関連するリスト。

出力¶

コマンド出力では、次の列にオファーのプロパティとメタデータが提供されます。

列	説明
`name`	オファー名。
`state`	オファーのステータス。次のいずれかです。 DRAFT PUBLISHED WITHDRAWN
`state_updated_on`	オファーの状態が最後に更新された日時。
`access_start_date_preference`	コンシューマーがリストにアクセスできるようになる希望の日付。次のいずれかです。 OFFER_ACCEPTED_DATE SPECIFIC_DATE
`comment`	プロバイダーによって追加されたオファーについてのコメント。
`contract_value`	合計契約金額。
`contract_type`	契約タイプ。次のいずれかです。 SUBSCRIPTION LIMITED_TIME PAY_AS_YOU_GO
`contract_duration_months`	契約期間（月単位）。
`invoice_start_date_preference`	希望の請求開始日。次のいずれかです。 OFFER_ACCEPTED_DATE SPECIFIC_DATE FIRST_DAY_NEXT_MONTH
`invoice_start_time`	請求が開始された日時。
`is_default`	デフォルトのオファーが価格設定プランに含まれることを指定します。次のいずれかです。 TRUE FALSE （デフォルト）
`display_name`	コンシューマーに表示されるオファー名。
`expiration_time`	オファーの有効期限が切れる日時。
`payment_terms`	追加の価格設定プランのパラメーター。次のいずれかです。 PAYMENT_TYPE INSTALLMENT_SCHEDULE ALLOWED_PAYMENT_METHODS
`pricing_plan_name`	オファーに関連する価格設定プラン。
`access_end_time`	コンシューマーがリストへのアクセスを失う日時。
`access_start_time`	コンシューマーがリストにアクセスできる日時。
`discount`	オファーの割引。
`target_consumer`	オファーのターゲットとなるコンシューマー。
`terms_of_service`	オファーに関連する利用規約。
`additional_information`	オファーに関する追加情報。
`updated_on`	オファーが最後に更新された日付。

アクセス制御の要件¶

権限	オブジェクト	メモ
CREATE LISTING	アカウント	Only the ACCOUNTADMIN role has this privilege by default. The privilege can be granted to additional roles as needed.

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

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

使用上の注意¶

このコマンドの出力を後処理するには、パイプ演算子（->>）または RESULT_SCAN 関数。どちらのコンストラクトも、出力をクエリできる結果セットとして扱います。

For example, you can use the pipe operator or RESULT_SCAN function to select specific columns from the SHOW command output or filter the rows.

When you refer to the output columns, use double-quoted identifiers for the column names. For example, to select the output column type, specify SELECT "type".

You must use double-quoted identifiers because the output column names for SHOW commands are in lowercase. The double quotes ensure that the column names in the SELECT list or WHERE clause match the column names in the SHOW command output that was scanned.

例¶

mylisting で myoffer で始まる名前のすべてのオファーを表示します。

SHOW OFFERS LIKE 'MYOFFER%' IN LISTING MYLISTING;

Copy