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

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 AVAILABLE OFFERS LIKE 'MYOFFER%' IN LISTING MYLISTING;

Copy