SHOW OFFERS¶

提供有关添加到某个列表中的所有要约的信息。

语法¶

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

Copy

LIKE 'pattern'

（可选）按对象名称筛选命令输出。筛选器使用不区分大小写的模式匹配，并支持 SQL 通配符（% 和 _）。

例如，以下模式返回相同的结果：

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

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

. 默认：无值（不对输出应用筛选）。

命令输出在以下列中提供要约属性和元数据：

列	描述
`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"。

显示所有名称以 myoffer 开头且在 mylisting 中的要约：

SHOW OFFERS LIKE 'MYOFFER%' IN LISTING MYLISTING;

Copy