SHOW AVAILABLE OFFERS¶

コマンドを実行したユーザーが使用できる、オファーを一覧表示します。

構文¶

SHOW AVAILABLE 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
`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
`access_end_time`	コンシューマーがリストへのアクセスを失う日時。
`access_start_time`	コンシューマーがリストにアクセスできる日時。
`discount`	オファーの割引。
`target_consumer`	オファーのターゲットとなるコンシューマー。
`terms_of_service`	オファーに関連する利用規約。
`additional_information`	追加のオファー情報。
`pricing_plan`	オファーに関連する価格設定プラン。
`updated_on`	オファーが最後に更新された日時。

アクセス制御の要件¶

権限	オブジェクト	メモ
PURCHASE DATA EXCHANGE LISTING	グローバル	この権限は、有料リストを購入する機能を付与します。この権限を持つロールを持っていない場合は、アカウント管理者にお問い合わせください。

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

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

使用上の注意¶

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

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

例¶

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

SHOW AVAILABLE OFFERS LIKE 'MYOFFER%' IN LISTING MYLISTING;

Copy