类别：

系统函数 （系统信息）

SYSTEM$LOCATE_DBT_ARCHIVE

返回 URL，您可以从中检索指定 dbt 项目的压缩 dbt 运行工件。

将此函数与 DBT_PROJECT_EXECUTION_HISTORY 函数结合使用，以编程方式访问 dbt 工件和日志。

语法

SYSTEM$LOCATE_DBT_ARCHIVE ( '<query_id>' )
Copy

实参

query_id

要查找其文件的 dbt 项目运行的查询 ID。

返回

此函数返回 URL，您可以从中检索指定 dbt 项目结果的压缩内容。

有关详细信息和示例，请参阅 以编程方式访问 dbt 工件和日志。

访问控制要求

此函数仅包括来自您具有以下权限的工作区和 dbt 项目的运行：

  • 工作区上的 OWNERSHIP 或 USAGE

  • dbt 项目上的 OWNERSHIP、USAGE 或 MONITOR

要对架构中的任何对象执行操作，需要对父数据库和架构的 USAGE 权限。请注意，如果某个角色获授某个架构的任意权限，该角色便能够解析该架构。例如，若某角色被授予 CREATE 权限，则可以在该架构上创建对象，而无需 同时 被授予该架构的 USAGE 权限。

有关创建具有指定权限集的自定义角色的说明，请参阅 创建自定义角色。

有关对 安全对象 执行 SQL 操作的相应角色和权限授予的一般信息，请参阅 访问控制概述。

使用说明

  • 此系统函数仅适用于 dbt 项目对象；它不适用于工作区。

  • 此系统函数不支持根据 CREATE DBT PROJECT 或 ALTER DBT PROJECT ... ADD VERSION 生成的查询 IDs。

  • 不支持直接查询文件内容（例如，查询示例）。

  • 如果 query_id 为 NULL，或者不是 dbt 执行，则会出现错误。

  • dbt 项目结果最多可保留 14 天。

  • 如果在上传之前运行超时、被取消或失败，文件可能不可用。在这种情况下，运行在 dbt 历史记录中显示为 UNHANDLED ERROR。

  • 您不能使用此函数获取正在进行的运行的日志，因为日志文件仅在运行完成后可用。

示例

以下示例返回指定执行的压缩工件（例如，dbt_artifacts.zip）的 snow:// URL。

您可以使用带 GET 的 URL 来下载 ZIP 文件（或 COPY FILES 以将其移动到自己的暂存区）。对于文件夹路径（而不是 ZIP），请使用 SYSTEM$LOCATE_DBT_ARTIFACTS。

SELECT SYSTEM$LOCATE_DBT_ARCHIVE($latest_query_id);
Copy

有关更多信息，请参阅 以编程方式访问 dbt 工件和日志。

语言: 中文