カテゴリ：: システム関数（システム情報）

SYSTEM$CATALOG_LINK_STATUS¶

指定された :doc:` カタログリンクデータベース </user-guide/tables-iceberg-catalog-linked-database>` のリンクステータスを返します。

こちらもご参照ください。: 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."
    }
  ]
}