以使用者身份通过 SQL 管理列表 – 示例

以下是使用者可以通过 SQL 命令以编程方式完成的常见任务示例：

显示可用列表

显示运行命令的使用者可用的列表。有关 SHOW AVAILABLE LISTINGS 命令的更多信息，请参阅 SHOW AVAILABLE LISTINGS。

描述

备注

显示可用列表。

IS_SHARED_WITH_ME = TRUE 用于仅显示与运行命令的使用者私下共享的列表。IS_IMPORTED = TRUE 用于仅显示导入的列表。

 
SHOW AVAILABLE LISTINGS
Copy

描述可用列表

运行 SHOW AVAILABLE LISTINGS 来识别可用列表和全局列表名称后，使用者可以运行 DESCRIBE AVAILABLE LISTING 来返回列表中可供其使用的列的描述。有关 DESCRIBE AVAILABLE LISTING 命令的更多信息，请参阅 DESCRIBE AVAILABLE LISTING。

描述

备注

描述列表列。

listing_global_name 用于识别要描述的特定全局列表。当 is_ready_for_import 列为 TRUE 时，数据已存在于该区域中，使用者可以立即导入数据。

 
DESCRIBE AVAILABLE LISTING < listing_global_name >
Copy

请求列表并自动轮询可用性

运行 SHOW AVAILABLE LISTINGS 来识别可用列表后，使用者可以使用 SYSTEM$REQUEST_LISTING_AND_WAIT 存储过程请求列表并自动轮询可用性。当 is_ready_for_import 列为 FALSE 时，使用者也可以使用此存储过程。有关 SYSTEM$REQUEST_LISTING_AND_WAIT 存储过程的更多信息，请参阅 SYSTEM$REQUEST_LISTING_AND_WAIT。

描述

备注

请求特定列表并轮询可用性。

<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)。

要请求列表而不等待列表履行，输入 0（零）即可返回 <timeout_mins> value. When the value is 0, the message Success: Listing <listing_global_name> requested successfully, but not waiting to confirm fulfillment。

 
CALL SYSTEM$REQUEST_LISTING_AND_WAIT( ' <listing_global_name> ' [ , <timeout_mins>. ] );
Copy

从列表中创建数据库

请求列表后，使用者可以使用 CREATE DATABASE ...FROM LISTING ... 命令从列表中创建数据库。有关 CREATE DATABASE ...FROM LISTING ... 命令的更多信息，请参阅 CREATE DATABASE ...FROM LISTING ...。

描述

备注

从列表中创建数据库。

<name> 指定数据库标识符。对于您的账户必须是唯一的。标识符必须以字母字符开头，且不能包含空格或特殊字符，除非整个标识符字符串放在双引号内。例如 "My object"。放在双引号内的标识符也区分大小写。

 
CREATE DATABASE <name> FROM LISTING '<listing_global_name>';
Copy
语言: 中文