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 函数。这两种构造都将输出视为可以查询的结果集。

    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.

示例

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

SHOW OFFERS LIKE 'MYOFFER%' IN LISTING MYLISTING;
Copy
语言: 中文