类别：: :doc:`/sql-reference/functions-system`（系统控制）

SYSTEM$REQUEST_LISTING_AND_WAIT¶

请求列表并自动轮询列表可用性。要了解有关列表的更多信息，请参阅关于列表共享。

语法¶

SYSTEM$REQUEST_LISTING_AND_WAIT( '<listing_global_name>' [ , <timeout_mins> ] )

Copy

实参¶

listing_global_name: 所请求的列表的全局名称。
timeout_mins: 在超时前等待列表请求履行的时间（以分钟为单位）。默认值为 240 分钟或 4 小时。

返回¶

当请求的列表变得可用或已经可用时，返回 Success: Listing <listing_global_name> is ready to be imported。
当超过指定的超时时间段时，返回 Error: Timed out waiting for the listing to be available after <timeout_mins> min(s)。

使用说明¶

要在不等待列表履行的情况下请求列表，请在 timeout_mins 值中输入 0`（零）。当值为 :code:`0 且请求成功时，将返回消息 Success: Listing < listing_global_name> requested successfully, but not waiting to confirm fulfillment。

示例¶

CALL SYSTEM$REQUEST_LISTING_AND_WAIT('GZ13Z1VEWIJ', 60);

Copy