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 関数。どちらのコンストラクトも、出力をクエリできる結果セットとして扱います。

このコマンドの出力列名は小文字で生成されます。パイプ演算子またはでこのコマンドの結果セットを消費する場合 RESULT_SCAN 関数の場合は、を使用します二重引用符で囲まれた識別子クエリの列名にを使用し、スキャンされた出力の列名と一致するようにします。たとえば、出力列の名前が次の場合 type``次にを指定します ``"type" 識別子用。

例¶

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

SHOW OFFERS LIKE 'MYOFFER%' IN LISTING MYLISTING;

Copy