类别：: 系统函数（系统信息）

SYSTEM$CATALOG_LINK_STATUS¶

返回指定的目录链接数据库的链接状态。

另请参阅：: 为 Apache Iceberg™ 表使用目录链接的数据库

语法¶

SYSTEM$CATALOG_LINK_STATUS( '<catalog_linked_db_name>' )

Copy

实参¶

'catalog_linked_db_name': 指定要检查其状态的目录链接的数据库的名称。

返回¶

该函数返回包含以下名称/值对的 JSON 对象：

{
  "executionState":"<value>",
  "failedExecutionStateReason":"<value>",
  "failedExecutionStateErrorCode":"<value>",
  "lastLinkAttemptStartTime":"<value>",
  "failureDetails":[
    {
      "qualifiedEntityName":"<value>",
      "entityDomain":"<value>",
      "operation":"<value>",
      "errorCode":"<value>",
      "errorMessage":"<value>"
    },
    { ... },
    ...
  ]
}

Copy

其中：

executionState
Snowflake 用于连接到您的 Iceberg 目录的链接操作的当前执行状态。

值：

RUNNING：下一次表发现同步已安排或正在执行；不能保证所有表都已成功同步。

FAILED：链接操作遇到错误且未成功。

failedExecutionStateReason
与 FAILED 执行状态相关的错误消息。如果上次同步尝试成功，则不会出现在函数输出中。

failedExecutionStateErrorCode
与 FAILED 执行状态相关的错误代码。如果上次同步尝试成功，则不会出现在函数输出中。

lastLinkAttemptStartTime
时间戳，标明 Snowflake 最近一次开始发现和同步远程目录中更改的时间。

failureDetails
一个对象数组，提供有关 Snowflake 无法同步的远程目录中实体（例如表）的详细信息。每个对象都具有以下字段：

qualifiedEntityName
远程目录中实体相对于目录名称的限定名称。

例如 namespace_level_1.namespace_level_2.table_name。

类型：字符串

entityDomain
远程目录中的实体域；例如 TABLE。

类型：字符串

operation
Snowflake 中与同步相关的操作；例如 CREATE（表或架构）、DROP。

类型：字符串

errorCode
与失败相关的错误代码。

类型：字符串

errorMessage
与失败相关的错误代码。

类型：字符串

使用说明¶

failureDetails 字段返回有关 DROP SCHEMA 和 DROP ICEBERG TABLE 失败的信息。
只要您使用对所指定目录链接的数据库具有权限的角色，就会返回结果。有关更多信息，请参阅数据库权限。

示例¶

检索名为 my_cld 的目录链接的数据库的链接状态：

SELECT SYSTEM$CATALOG_LINK_STATUS('my_cld');

Copy

输出：

{
  "executionState": "RUNNING",
  "lastLinkAttemptStartTime": "2025-02-14T01:35:01.71Z",
  "failureDetails": [
    {
      "qualifiedEntityName": "my_namespace.table_1",
      "entityDomain": "TABLE",
      "operation": "CREATE",
      "errorCode": "0040000",
      "errorMessage": "An internal error occurred. Please contact Snowflake support."
    },
    {
      "qualifiedEntityName": "my_namespace.table_2",
      "entityDomain": "TABLE",
      "operation": "CREATE",
      "errorCode": "0040000",
      "errorMessage": "An internal error occurred. Please contact Snowflake support."
    }
  ]
}