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 関数を使用して、 SHOW コマンド出力から特定の列を選択したり、行をフィルター処理したりできます。

出力列を参照する場合は、列名に二重引用符で囲まれた識別子を使用します。たとえば、出力列 type を選択するには、 SELECT "type" を指定します。

SHOW コマンドの出力列名は小文字のため、二重引用符で囲まれた識別子を使用する必要があります。二重引用符により、 SELECT リストまたは WHERE 句内の列名が、スキャンされた SHOW コマンド出力内の列名と一致することが保証されます。

例¶

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

SHOW OFFERS LIKE 'MYOFFER%' IN LISTING MYLISTING;

Copy