GoogleSQL 方言資料庫的資訊結構定義

資訊結構定義是每個 Spanner 資料庫通用的內建結構定義。您可以對 INFORMATION_SCHEMA 中的資料表執行 SQL 查詢，以擷取資料庫的結構定義中繼資料。

舉例來說，下列查詢會擷取資料庫中所有使用者定義資料表的名稱：

  SELECT
    table_schema,
    table_name
  FROM
    information_schema.tables
  WHERE
    table_schema NOT IN ('information_schema', 'SPANNER_SYS')
    AND table_type = 'BASE TABLE'

精細存取控管使用者會根據資料庫角色，看到部分 INFORMATION_SCHEMA 資料表的篩選結果。詳情請參閱「關於精細的存取控管」。

用量

INFORMATION_SCHEMA 資料表只能透過 SQL 介面存取，例如：

  • executeQuery API
  • gcloud spanner databases execute-sql 指令
  • Google Cloud 控制台中資料庫的「Spanner Studio」頁面

其他單一讀取方法不支援 INFORMATION_SCHEMA。

INFORMATION_SCHEMA 的其他使用注意事項：

篩選 information_schema 資料表中的資料列

具備資料庫層級 IAM 權限的主體，以及獲授予 spanner_info_reader 系統角色 (或該角色成員) 存取權的主體，可以查看所有 information_schema 資料表中的所有資料列。對於其他主體，某些資料表的資料列會根據目前的資料庫角色進行篩選。下列各節的資料表和檢視表說明，指出如何為每個資料表和檢視表套用資料列篩選。

INFORMATION_SCHEMA 中的資料表

以下各節說明 GoogleSQL 方言資料庫的 INFORMATION_SCHEMA 中的資料表。

SCHEMATA

INFORMATION_SCHEMA.SCHEMATA 資料表會列出資料庫中的結構定義。包括資訊結構定義和命名結構定義，其中包含您定義的資料表。

資料欄名稱 類型 說明
CATALOG_NAME STRING 目錄的名稱。這個資料欄是為了與 SQL 標準資訊結構定義資料表相容而存在。這個資料欄一律為空白字串。
SCHEMA_NAME STRING 結構定義的名稱。這是具名結構定義的名稱，或預設結構定義的 ``。
PROTO_BUNDLE STRING 如果資料庫包含 proto 繫結陳述式，這個資料欄會提供結構定義中使用的 proto 繫結相關資訊。如果資料庫中沒有 proto 組合，這個資料欄會是 NULL。

DATABASE_OPTIONS

下表列出資料庫設定的選項。

資料欄名稱 類型 說明
CATALOG_NAME STRING 目錄的名稱。一律為空字串。
SCHEMA_NAME STRING 結構定義的名稱。如果未命名，則為空白字串。
OPTION_NAME STRING 資料庫選項的名稱。
OPTION_TYPE STRING 資料庫選項的資料類型。
OPTION_VALUE STRING 資料庫選項值。

PLACEMENTS

這個表格列出了資料庫中的刊登位置。

資料欄名稱 類型 說明
PLACEMENT_NAME STRING 刊登位置名稱。
IS_DEFAULT BOOL 布林值，指出刊登位置是否為預設刊登位置。

PLACEMENT_OPTIONS

下表列出各個刊登位置在 CREATE PLACEMENT 陳述式的 OPTIONS 子句中設定的選項。

OPTION_NAME 的有效值包括：

  • instance_partition
  • default_leader
資料欄名稱 類型 說明
PLACEMENT_NAME STRING 刊登位置名稱。
OPTION_NAME STRING 刊登位置選項的名稱。
OPTION_TYPE STRING 刊登位置選項的資料類型。無論選擇哪種方式，這個值都是 STRING(MAX)。
OPTION_VALUE STRING 刊登位置選項的值。instance_partition 是執行個體分區的名稱。如果是 default_leader，則為預設主要區域的名稱。

LOCALITY_GROUP_OPTIONS

下表列出每個位置群組的名稱，以及在 CREATE LOCALITY GROUP 陳述式的 OPTIONS 子句中，為位置群組設定的選項。

資料欄名稱 類型 說明
LOCALITY_GROUP_NAME STRING 地區群組名稱。
OPTION_NAME STRING 地區群組選項的名稱。有效選項如下：
  • STORAGE：定義位置群組的儲存空間類型。
  • SSD_TO_HDD_SPILL_TIMESPAN：定義資料在 SSD 儲存空間中儲存多久後，會移至 HDD 儲存空間。
OPTION_VALUE STRING 位置群組選項的值。如果是 STORAGE，則為 ssd 或 hdd。如果是 SSD_TO_HDD_SPILL_TIMESPAN，這是資料必須儲存在 SSD 中，才能移至 HDD 儲存空間的時間長度。例如，10d 是 10 天。可設定的最短時間為一小時。

TABLES

這個資料表已篩選資料列，列出資料庫中的資料表和檢視表。如果主體具備資料庫層級 IAM 權限，且已獲授予 spanner_info_reader 系統角色或該角色成員的存取權，則可查看這個檢視表中的所有資料列。所有其他主體只能查看符合下列任一條件的資料表：

  • SELECT、INSERT、UPDATE 或 DELETE 精細的存取控管權限已授予資料表的目前資料庫角色、目前資料庫角色所屬的角色，或 public。
  • SELECT、INSERT 或 UPDATE 權限已授予任何資料表資料欄，對象為目前的資料庫角色、目前資料庫角色所屬的角色，或 public。
資料欄名稱 類型 說明
TABLE_CATALOG STRING 未使用。一律為空字串。
TABLE_SCHEMA STRING 資料表的結構定義名稱。預設結構定義的名稱為空白，其他結構定義則包含值。這個資料欄一律會包含值。
TABLE_NAME STRING 資料表、檢視表或同義詞的名稱。
TABLE_TYPE STRING 資料表類型，資料表的值為 BASE TABLE；檢視表的值為 VIEW；同義詞的值為 SYNONYM。
PARENT_TABLE_NAME STRING 如果這個資料表為交錯，則為上層資料表的名稱，否則為 NULL。
ON_DELETE_ACTION STRING 如果是交錯資料表，這個值會設為 CASCADE 或 NO ACTION，否則會設為 NULL。詳情請參閱「TABLE 陳述式」。
SPANNER_STATE STRING 如果涉及大量作業，資料表在建立期間可能會經歷多種狀態。例如，建立資料表時，外鍵需要回填索引。可能的狀態包括：
  • ADDING_FOREIGN_KEY：新增資料表的外鍵。
  • WAITING_FOR_COMMIT：完成結構定義變更。
  • COMMITTED：建立資料表的結構定義變更已提交。變更提交後，才能寫入資料表。
INTERLEAVE_TYPE STRING 運算式文字，指出這個資料表與交錯資料表之間是否有父項/子項關係。可能的值包括：
  • IN：資料表沒有父項與子項關係。無論父項資料表資料列是否存在，這個資料表中的資料列都可以存在。
  • IN PARENT：資料表具有上下層關係。 這個資料表中的資料列必須有父項資料表資料列。
  • 空字串表示這個資料表沒有交錯關係。
ROW_DELETION_POLICY_EXPRESSION STRING 定義資料表資料列刪除政策的運算式文字。例如 OLDER_THAN(CreatedAt, INTERVAL 1 DAY) 或 OLDER_THAN(ExpiredDate, INTERVAL 0 DAY)。

COLUMNS

這個資料列篩選資料表會列出資料表中的資料欄。如果主體具備資料庫層級 IAM 權限，且有權存取 spanner_info_reader 系統角色或該角色的成員，則可查看這個檢視表中的所有資料列。所有其他主體只能查看符合下列任一條件的資料欄：

  • SELECT、INSERT 或 UPDATE 精細的存取控管權限，直接授予資料欄給目前的資料庫角色、目前資料庫角色所屬的角色，或 public。
  • SELECT、INSERT 或 UPDATE 精細存取控管權限，已授予包含該資料欄的資料表，對象為目前的資料庫角色、目前資料庫角色所屬的角色，或 public。
資料欄名稱 類型 說明
TABLE_CATALOG STRING 未使用。一律為空字串。
TABLE_SCHEMA STRING 資料欄所屬資料表的結構定義名稱。預設結構定義的名稱為空白，其他結構定義則包含值。這個資料欄一律會包含值。
TABLE_NAME STRING 資料表的名稱。
COLUMN_NAME STRING 資料欄的名稱。
ORDINAL_POSITION INT64 資料欄在資料表中的序數位置，值從 1 開始。
COLUMN_DEFAULT STRING

資料欄預設值的 SQL 運算式字串表示法。如果資料欄沒有預設值，則為 NULL。

注意：在 2022 年 3 月之前，COLUMN_DEFAULT 使用的是 BYTES 類型。
DATA_TYPE STRING 為符合 SQL 標準而加入。一律NULL。請參閱「SPANNER_TYPE」欄
IS_NULLABLE STRING 指定資料欄是否可為 Null 值的字串。根據 SQL 標準，字串為 YES 或 NO，而非布林值。
SPANNER_TYPE STRING 資料欄的資料類型。
IS_GENERATED STRING 指出是否產生資料欄的字串。如果是產生的資料欄，字串為 ALWAYS；如果是非產生的資料欄，字串則為 NEVER。
GENERATION_EXPRESSION STRING 代表生成資料欄 SQL 運算式的字串。如果資料欄不是產生的資料欄，則為 NULL。
IS_STORED STRING 表示是否儲存產生的資料欄。產生的資料欄一律為 YES 字串，非產生的資料欄則為 NULL。
IS_HIDDEN STRING 如果資料欄未出現在 SELECT * 查詢中，則字串會設為 TRUE，否則會設為 FALSE。如果資料欄已隱藏，您仍可使用其名稱 (例如 SELECT Id, Name, ColHidden FROM TableWithHiddenColumn) 選取。
SPANNER_STATE STRING 資料欄的目前狀態。新增至現有資料表的已儲存生成資料欄，可能需要經過多個使用者可觀察的狀態，才能完全使用。可能的值包括：
  • WRITE_ONLY：資料欄正在回填。不允許讀取。
  • COMMITTED：資料欄可完整使用。
IS_IDENTITY STRING 如果產生的資料欄是身分資料欄，則字串會設為 YES，否則會設為 NO。
IDENTITY_GENERATION STRING 這個字串會指定資料欄是否僅允許產生的值，而不允許使用者插入的自訂值。
  • BY DEFAULT：預設值。BY DEFAULT 指定在未提供使用者插入值時，資料欄應使用生成值。
  • ALWAYS：資料欄只允許系統產生的值，不允許使用者自訂插入的值。
IDENTITY_KIND STRING 一律BIT_REVERSED_POSITITVE_SEQUENCE。僅支援位元反轉的正序列。
IDENTITY_START_WITH_COUNTER STRING 轉換前內部計數器的起始值。例如，位元反轉前的起始值。
IDENTITY_SKIP_RANGE_MIN STRING 轉換後略過範圍的最小值。
IDENTITY_SKIP_RANGE_MAX STRING 轉換後略過範圍的最大值。
ON_UPDATE_EXPRESSION STRING STRING，包含資料欄 `ON UPDATE` 運算式的 SQL 表示法。如果資料欄沒有 `ON UPDATE` 值，則值為 `NULL`。

COLUMN_PRIVILEGES

這個資料列篩選資料表會列出在資料欄層級授予任何資料庫角色的所有權限，包括 public。具備資料庫層級 IAM 權限的主體，以及有權存取 spanner_info_reader 系統角色或該角色成員的主體，可以查看這個檢視表中的所有資料列。所有其他主體只能查看符合下列任一條件的資料欄權限：

  • SELECT、INSERT 或 UPDATE 精細存取控管權限，直接授予目前資料庫角色的資料欄、目前資料庫角色所屬的角色，或 public。
  • SELECT、INSERT 或 UPDATE 精細存取控管權限，已授予包含該資料欄的資料表，對象為目前的資料庫角色、目前資料庫角色所屬的角色，或 public。
資料欄名稱 類型 說明
TABLE_CATALOG STRING 未使用。一律為空字串。
TABLE_SCHEMA STRING 資料欄所屬資料表的結構定義名稱。預設結構定義的名稱為空白，其他結構定義則包含值。這個資料欄一律會包含值。
TABLE_NAME STRING 含有特殊權限資料欄的資料表名稱。
COLUMN_NAME STRING 特殊權限資料欄的名稱。
PRIVILEGE_TYPE STRING SELECT、INSERT、UPDATE
GRANTEE STRING 授予這項權限的資料庫角色名稱。

TABLE_PRIVILEGES

這個資料表經過資料列篩選，列出在資料表層級授予資料庫角色的所有權限，包括 public。具備資料庫層級 IAM 權限的主體，以及有權存取 spanner_info_reader 系統角色或該角色成員的主體，可以查看這個檢視表中的所有資料列。所有其他主體只能查看資料表的權限，前提是目前資料庫角色、目前資料庫角色所屬的角色，或 public 具備 SELECT、INSERT、UPDATE 或 DELETE 精細的存取控管權限。

資料欄名稱 類型 說明
TABLE_CATALOG STRING 未使用。一律為空字串。
TABLE_SCHEMA STRING 資料表的結構定義名稱。預設結構定義的名稱為空白，其他結構定義則包含值。這個資料欄一律會包含值。
TABLE_NAME STRING 已授予精細的存取控管權限的資料表名稱。
PRIVILEGE_TYPE STRING SELECT、INSERT、UPDATE 和 DELETE 之一
GRANTEE STRING 授予這項權限的資料庫角色名稱。

TABLE_CONSTRAINTS

這個資料表會為資料庫中資料表定義的每項限制，各建立一個資料列。

資料欄名稱 類型 說明
CONSTRAINT_CATALOG STRING 一律為空字串。
CONSTRAINT_SCHEMA STRING 限制結構定義的名稱。如果未命名，則為空白字串。
CONSTRAINT_NAME STRING 限制名稱。
TABLE_CATALOG STRING 受限制資料表的目錄名稱。一律為空字串。
TABLE_SCHEMA STRING 受限制資料表的結構定義名稱。預設結構定義的名稱為空白，其他結構定義則包含值。這個資料欄一律會包含值。
TABLE_NAME STRING 受限制資料表的名稱。
CONSTRAINT_TYPE STRING 限制類型。可能的值包括：
  • PRIMARY KEY
  • FOREIGN KEY
  • PLACEMENT KEY
  • CHECK
  • UNIQUE
IS_DEFERRABLE STRING 一律NO。
INITIALLY_DEFERRED STRING 一律NO。
ENFORCED STRING NO：如果限制是 資訊 (NOT ENFORCED) 外鍵。YES：強制執行的外鍵或任何其他限制類型。

CONSTRAINT_TABLE_USAGE

這個表格列出定義或使用限制的資料表。包含定義 PRIMARY KEY 和 UNIQUE 限制的資料表。也包含 FOREIGN KEY 定義的參考表格。

資料欄名稱 類型 說明
TABLE_CATALOG STRING 受限制資料表的目錄名稱。一律為空字串。
TABLE_SCHEMA STRING 受限制資料表的結構定義名稱。預設結構定義的名稱為空白，其他結構定義則包含值。這個資料欄一律會包含值。
TABLE_NAME STRING 受限制資料表的名稱。
CONSTRAINT_CATALOG STRING 限制目錄的名稱，一律為空字串。
CONSTRAINT_SCHEMA STRING 限制結構定義的名稱。如果未命名，則為空白字串。
CONSTRAINT_NAME STRING 限制名稱。

REFERENTIAL_CONSTRAINTS

這個資料表包含每個 FOREIGN KEY 限制的一列。

資料欄名稱 類型 說明
CONSTRAINT_CATALOG STRING 外鍵目錄的名稱，一律為空字串。
CONSTRAINT_SCHEMA STRING 外鍵的結構定義名稱。如果未命名，則為空白字串。
CONSTRAINT_NAME STRING 外鍵名稱。
UNIQUE_CONSTRAINT_CATALOG STRING FOREIGN KEY 參照的 PRIMARY KEY 或 UNIQUE 限制目錄名稱。一律為空字串。
UNIQUE_CONSTRAINT_SCHEMA STRING 外鍵參照的主鍵或 UNIQUE 限制的結構定義名稱。如果未命名，則為空白字串。
UNIQUE_CONSTRAINT_NAME STRING 外鍵參照的主鍵或 UNIQUE 限制名稱。
MATCH_OPTION STRING 一律SIMPLE。
UPDATE_RULE STRING 一律NO ACTION。
DELETE_RULE STRING CASCADE、SET NULL 或 NO ACTION。
SPANNER_STATE STRING 外鍵的目前狀態。Spanner 會等到外鍵的支援索引建立並回填後，才開始強制執行限制。索引準備就緒後，Spanner 會開始對新交易強制執行限制，同時驗證現有資料。可能的值和代表的狀態如下：
  • BACKFILLING_INDEXES：正在補充索引。
  • VALIDATING_DATA：正在驗證現有資料和新寫入作業。
  • WAITING_FOR_COMMIT：外鍵大量作業已順利完成，或不需要執行任何作業，但外鍵仍處於待處理狀態。
  • COMMITTED：結構定義變更已提交。

CHECK_CONSTRAINTS

information_schema.CHECK_CONSTRAINTS 資料表包含一列，其中包含由 CHECK 或 NOT NULL 關鍵字定義的每個 CHECK 限制。

資料欄名稱 類型 說明
CONSTRAINT_CATALOG STRING 限制目錄的名稱，這個資料欄一律不會是空值，但一律會是空白字串。
CONSTRAINT_SCHEMA STRING 限制結構定義的名稱。如果未命名，則為空白字串。
CONSTRAINT_NAME STRING 限制名稱。這個資料欄絕不會是 Null 值。如未在結構定義定義中明確指定，系統會指派系統定義的名稱。
CHECK_CLAUSE STRING CHECK 限制的運算式。這個資料欄絕不會是 Null 值。
SPANNER_STATE STRING CHECK 限制的目前狀態。這個資料欄絕不會是空值。可能的狀態如下：
  • VALIDATING：Spanner 正在驗證現有資料。
  • COMMITTED：這項限制沒有有效的結構定義變更。

KEY_COLUMN_USAGE

這個資料列篩選資料表包含 TABLE_CONSTRAINTS 中資料表各資料欄的一列，這些資料欄受 PRIMARY KEY、FOREIGN KEY 或 UNIQUE 限制約束為索引鍵。具備資料庫層級 IAM 權限的主體，以及有權存取 spanner_info_reader 系統角色或該角色成員的主體，可以查看這個檢視表中的所有資料列。所有其他主體只能查看符合下列條件的資料欄：

  • SELECT、INSERT 或 UPDATE 精細的存取控管權限，直接授予資料欄給目前的資料庫角色、目前資料庫角色所屬的角色，或 public。
  • SELECT、INSERT 或 UPDATE 精細的存取控管權限，已授予包含該資料欄的資料表，對象為目前的資料庫角色、目前資料庫角色所屬的角色，或 public。
資料欄名稱 類型 說明
CONSTRAINT_CATALOG STRING 限制目錄的名稱，一律為空字串。
CONSTRAINT_SCHEMA STRING 限制結構定義的名稱。這個資料欄絕不會是 Null 值。如果未命名，則為空白字串。
CONSTRAINT_NAME STRING 限制名稱。
TABLE_CATALOG STRING 受限制資料欄的目錄名稱。一律為空字串。
TABLE_SCHEMA STRING 受限制資料欄的資料表結構定義名稱。預設結構定義的名稱為空白，其他結構定義則包含值。這個資料欄一律會包含值。
TABLE_NAME STRING 受限制資料欄的資料表名稱。
COLUMN_NAME STRING 資料欄的名稱。
ORDINAL_POSITION INT64 資料欄在限制鍵中的序數位置，從 1 值開始。
POSITION_IN_UNIQUE_CONSTRAINT INT64 如果是 FOREIGN KEY，則為資料欄在不重複限制中的序數位置，從 1 值開始。如果是其他限制類型，這個資料欄會是空值。

CONSTRAINT_COLUMN_USAGE

這個資料表包含一列，說明限制使用的每個資料欄。包含 PRIMARY KEY 和 UNIQUE 資料欄，以及 FOREIGN KEY 限制的參照資料欄。

資料欄名稱 類型 說明
TABLE_CATALOG STRING 資料欄資料表的目錄名稱。一律為空字串。
TABLE_SCHEMA STRING 資料欄所屬資料表的結構定義名稱。預設結構定義的名稱為空白，其他結構定義則包含值。這個資料欄一律會包含值。
TABLE_NAME STRING 資料欄所屬資料表的名稱。
COLUMN_NAME STRING 限制使用的資料欄名稱。
CONSTRAINT_CATALOG STRING 限制目錄的名稱，一律為空字串。
CONSTRAINT_SCHEMA STRING 限制結構定義的名稱。如果未命名，則為空白字串。
CONSTRAINT_NAME STRING 限制名稱。

TABLE_SYNONYMS

這個表格列出資料表的同義詞資訊。

資料欄名稱 類型 說明
TABLE_CATALOG STRING 未使用。一律為空字串。
TABLE_SCHEMA STRING 資料表的結構定義名稱。預設結構定義的名稱為空白，其他結構定義則包含值。這個資料欄一律會包含值。
TABLE_NAME STRING 資料表的名稱。
SYNONYM_CATALOG STRING 同義詞的目錄名稱。
SYNONYM_SCHEMA STRING 同義詞的結構定義名稱。
SYNONYM_TABLE_NAME STRING 同義詞的資料表名稱。

INDEXES

這個資料列篩選資料表會列出資料庫中的索引。如果主體具備資料庫層級 IAM 權限，且有權存取 spanner_info_reader 系統角色或該角色的成員，則可查看這個檢視表中的所有資料列。其他主體只能查看符合下列任一條件的索引：

  • 在資料欄層級，將 SELECT、INSERT 或 UPDATE 精細的存取控管權限，授予索引中的「所有」資料欄，對象為目前的資料庫角色、目前資料庫角色所屬的角色，或 public。
  • SELECT、INSERT、UPDATE 或 DELETE 精細的存取控管權限，已授予具有索引的資料表，授予目前資料庫角色、目前資料庫角色所屬的角色，或 public。
資料欄名稱 類型 說明
TABLE_CATALOG STRING 目錄的名稱。一律為空字串。
TABLE_SCHEMA STRING 索引資料表的結構定義名稱。預設結構定義的名稱為空白，其他結構定義則包含值。這個資料欄一律會包含值。
TABLE_NAME STRING 資料表的名稱。
INDEX_NAME STRING 索引的名稱。具有 PRIMARY KEY 規格的資料表會產生名為 PRIMARY_KEY 的虛擬索引項目，以便判斷主鍵的欄位。
INDEX_TYPE STRING 索引的類型。類型為 INDEX 或 PRIMARY_KEY。
PARENT_TABLE_NAME STRING 次要索引可以交錯嵌入上層資料表，詳情請參閱「建立次要索引」。這個資料欄會保留父項資料表的名稱，如果索引未交錯，則會保留空白字串。
IS_UNIQUE BOOL 索引鍵是否不得重複。
IS_NULL_FILTERED BOOL 索引是否包含具有 NULL 值的項目。
INDEX_STATE STRING 索引的目前狀態。可能的值和代表的狀態如下：
  • PREPARE：為新索引建立空白資料表。
  • WRITE_ONLY：為新索引補充資料。
  • WRITE_ONLY_CLEANUP：清除新索引。
  • WRITE_ONLY_VALIDATE_UNIQUE：檢查新索引中的資料是否不重複。
  • READ_WRITE：一般索引作業。
SPANNER_IS_MANAGED BOOL 如果索引由 Spanner 管理，則為 TRUE；否則為 FALSE。外鍵的次要支援索引由 Spanner 管理。

INDEX_COLUMNS

這個資料列篩選資料表會列出索引中的資料欄。如果主體具備資料庫層級 IAM 權限，且有權存取 spanner_info_reader 系統角色或該角色的成員，則可查看這個檢視表中的所有資料列。其他主體只能查看符合下列任一條件的索引：

  • 在資料欄層級，將 SELECT、INSERT 或 UPDATE 精細的存取控管權限，授予索引中的「所有」資料欄，對象為目前的資料庫角色、目前資料庫角色所屬的角色，或 public。
  • SELECT、INSERT 或 UPDATE 精細存取控管權限，已授予具有目前資料庫角色索引的資料表、目前資料庫角色所屬的角色，或 public。
資料欄名稱 類型 說明
TABLE_CATALOG STRING 目錄的名稱。一律為空字串。
TABLE_SCHEMA STRING 索引資料表的結構定義名稱。預設結構定義的名稱為空白，其他結構定義則包含值。這個資料欄一律會包含值。
TABLE_NAME STRING 資料表的名稱。
INDEX_NAME STRING 索引的名稱。
COLUMN_NAME STRING 資料欄的名稱。
ORDINAL_POSITION INT64 資料欄在索引 (或主鍵) 中的序數位置，從 1 開始。對於非索引鍵資料欄 (例如在索引的 STORING 子句中指定的資料欄)，這個值為 NULL。
COLUMN_ORDERING STRING 資料欄的排序。索引鍵資料欄的值為 ASC 或 DESC，非索引鍵資料欄的值則為 NULL (例如在索引的 STORING 子句中指定的資料欄)。
IS_NULLABLE STRING 指定資料欄是否可為 Null 值的字串。根據 SQL 標準，字串為 YES 或 NO，而非布林值。
SPANNER_TYPE STRING 資料欄的資料類型。

COLUMN_OPTIONS

這個資料列篩選資料表列出了資料表中的資料欄選項。如果主體具備資料庫層級 IAM 權限，且已獲授予 spanner_info_reader 系統角色或該角色成員的存取權，則可查看這個檢視表中的所有資料列。所有其他主體只能看到符合下列任一條件的資料欄選項：

  • SELECT、INSERT 或 UPDATE 精細存取控管權限，直接授予目前資料庫角色的資料欄、目前資料庫角色所屬的角色，或 public。
  • SELECT、INSERT 或 UPDATE 精細存取控管權限，已授予包含該資料欄的資料表，對象為目前的資料庫角色、目前資料庫角色所屬的角色，或 public。
資料欄名稱 類型 說明
TABLE_CATALOG STRING 目錄的名稱。一律為空字串。
TABLE_SCHEMA STRING 結構定義的名稱。預設結構定義的名稱為空白，其他結構定義 (例如 INFORMATION_SCHEMA 本身) 的名稱則非空白。這個資料欄絕不會是 Null 值。
TABLE_NAME STRING 資料表的名稱。
COLUMN_NAME STRING 資料欄的名稱。
OPTION_NAME STRING 可唯一識別選項的 SQL 識別碼。這個 ID 是 DDL 中 OPTIONS 子句的索引鍵。
OPTION_TYPE STRING 資料類型名稱，代表這個選項值的類型。
OPTION_VALUE STRING 說明這個選項值的 SQL 常值。這個資料欄的值必須可做為查詢的一部分進行剖析。剖析值產生的運算式必須可轉換為 OPTION_TYPE。這個資料欄絕不會是 Null 值。

SEQUENCES

這個表格列出序列中繼資料。如果使用者具備精細存取權限，系統會根據精細存取權限，對 SEQUENCES 進行資料列篩選。

資料欄名稱 類型 說明
CATALOG STRING 序列所在目錄的名稱。
SCHEMA STRING 包含序列的結構定義名稱。
NAME STRING 序列名稱。
DATA_TYPE STRING 序列值的類型。使用 INT64 資料類型。

SEQUENCE_OPTIONS

下表列出序列的設定選項。SEQUENCE_OPTIONS 會根據精細存取權限進行資料列篩選，如果使用者具備精細存取權限，則會查詢該資料表。

資料欄名稱 類型 說明
CATALOG STRING 序列所在目錄的名稱。
SCHEMA STRING 包含序列的結構定義名稱。
NAME STRING 序列名稱。
OPTION_NAME STRING 序列選項的名稱。
OPTION_TYPE STRING 資料類型名稱，也就是這個選項值的類型。
OPTION_VALUE STRING 序列選項值。剖析值後產生的運算式必須允許轉換為 OPTION_TYPE。

SPANNER_STATISTICS

下表列出可用的查詢最佳化工具統計資料套件。

資料欄名稱 類型 說明
CATALOG_NAME STRING 目錄的名稱。一律為空字串。
SCHEMA_NAME STRING 結構定義的名稱。預設結構定義的名稱為空白，其他結構定義 (例如 INFORMATION_SCHEMA 本身) 的名稱則非空白。這個資料欄絕不會是 Null 值。
PACKAGE_NAME STRING 統計資料套件的名稱。
ALLOW_GC BOOL 如果統計資料套件不受垃圾收集影響，則為 FALSE；否則為 TRUE。
這個屬性必須設為 FALSE，才能在提示中或透過用戶端 API 參照統計資料套件。

VIEWS

這個資料表會列出資料庫中的檢視表，並依資料列篩選。如果主體具備資料庫層級 IAM 權限，且有權存取 spanner_info_reader 系統角色或該角色的成員，則可查看這個檢視表中的所有資料列。所有其他主體只能查看已將 SELECT 精細的存取控管權限授予下列角色的檢視表：目前資料庫角色、目前資料庫角色所屬的角色，或 public。

資料欄名稱 類型 說明
TABLE_CATALOG STRING 目錄的名稱。一律為空字串。
TABLE_SCHEMA STRING 結構定義的名稱。如果未命名，則為空白字串。
TABLE_NAME STRING 檢視表名稱。
VIEW_DEFINITION STRING 定義檢視表的查詢 SQL 文字。
SECURITY_TYPE STRING 檢視表的安全性類型。INVOKER 或 DEFINER。

詳情請參閱「關於檢視畫面」。

ROLES

這個資料表已篩選資料列，列出精細存取控管定義的資料庫角色，包括系統角色。具備資料庫層級 IAM 權限的主體，以及已獲授予 spanner_info_reader 系統角色或該角色成員存取權的主體，可以查看所有資料庫角色。其他主體只能查看直接或透過繼承方式取得存取權的資料庫角色。

資料欄名稱 類型 說明
ROLE_NAME STRING 資料庫角色名稱。
IS_SYSTEM BOOL 如果資料庫角色是系統角色，則為 TRUE；否則為 FALSE。

ROLE_GRANTEES

這個資料表已篩選資料列，列出明確授予所有資料庫角色的所有角色成員資格。具備資料庫層級 IAM 權限的主體，以及獲派 spanner_info_reader 系統角色或該角色成員存取權的主體，可以查看這個檢視表中的所有資料列。所有其他主體只能查看授予目前資料庫角色的角色成員資格，或目前資料庫角色所屬角色的成員資格。

由於所有資料庫角色都是公開角色的成員，因此結果會省略公開角色中隱含成員資格的記錄。

資料欄名稱 類型 說明
ROLE_NAME STRING 授予這項成員資格的資料庫角色名稱。
GRANTEE STRING 獲授予這項成員資格的資料庫角色名稱。

CHANGE_STREAMS

這個資料列篩選資料表會列出資料庫的所有變更串流，並註明哪些變更串流會追蹤整個資料庫，哪些會追蹤特定資料表或資料欄。具備資料庫層級 IAM 權限的主體，以及獲授予 spanner_info_reader 系統角色或該角色成員存取權的主體，可以查看這個檢視表中的所有資料列。所有其他主體只能查看變更串流，前提是 SELECT FGAC 權限已授予目前資料庫角色、目前資料庫角色所屬的角色，或 public。

資料欄名稱 類型 說明
CHANGE_STREAM_CATALOG STRING 變更串流的目錄名稱，一律為空字串。
CHANGE_STREAM_SCHEMA STRING 這個變更串流的結構定義名稱。一律為空字串。
CHANGE_STREAM_NAME STRING 變更串流的名稱。
ALL BOOL 如果這個變更串流追蹤整個資料庫，則為 TRUE。如果這個變更串流追蹤特定資料表或資料欄，則為 FALSE。

CHANGE_STREAM_TABLES

這個資料表經過資料列篩選，包含資料表和監控資料表的變更串流相關資訊。每一列會說明一個資料表和一個變更串流。如果主體具備資料庫層級 IAM 權限，且已獲授予 spanner_info_reader 系統角色或該角色成員的存取權，則可查看這個檢視表中的所有資料列。所有其他主體只能查看變更串流的資料列，前提是 SELECT 權限已授予目前的資料庫角色、目前資料庫角色所屬的角色，或 public。

CHANGE_STREAM_TABLES 中的資料不包含資料表與追蹤整個資料庫的變更串流之間的隱含關係。

資料欄名稱 類型 說明
CHANGE_STREAM_CATALOG STRING 變更串流的目錄名稱。一律為空字串。
CHANGE_STREAM_SCHEMA STRING 變更串流的結構定義名稱。一律為空字串。
CHANGE_STREAM_NAME STRING 這個資料列參照的變更串流名稱。
TABLE_CATALOG STRING 資料表的目錄名稱，一律為空字串。
TABLE_SCHEMA STRING 資料表結構定義的名稱。一律為空字串。
TABLE_NAME STRING 這個資料列參照的資料表名稱。
ALL_COLUMNS BOOL 如果這個資料列的變更串流會追蹤這個資料列參照的整個資料表，則為 TRUE。否則，FALSE。

CHANGE_STREAM_COLUMNS

這個資料表已篩選資料列，包含資料表資料欄和監控這些資料欄的異動串流相關資訊。每一列會說明一個變更串流和一個資料欄。如果變更串流追蹤整個資料表，則該資料表中的資料欄不會顯示在這個檢視畫面中。

具備資料庫層級 IAM 權限的主體，以及已獲授予 spanner_info_reader 系統角色或該角色成員存取權的主體，可以查看這個檢視表中的所有資料列。所有其他主體只能查看變更串流的資料列，前提是目前資料庫角色、目前資料庫角色所屬的角色，或 public 具備 SELECT 權限。

資料欄名稱 類型 說明
CHANGE_STREAM_CATALOG STRING 變更串流的目錄名稱。一律為空字串。
CHANGE_STREAM_SCHEMA STRING 變更串流的結構定義名稱。一律為空字串。
CHANGE_STREAM_NAME STRING 變更串流的名稱。
TABLE_CATALOG STRING 資料表的目錄名稱，一律為空字串。
TABLE_SCHEMA STRING 資料表結構定義的名稱。一律為空字串。
TABLE_NAME STRING 這個資料列參照的資料表名稱。
COLUMN_NAME STRING 這個資料列參照的資料欄名稱。

CHANGE_STREAM_OPTIONS

這個資料列篩選資料表包含變更串流的設定選項。具備資料庫層級 IAM 權限的主體，以及獲授予 spanner_info_reader 系統角色或該角色成員存取權的主體，可以查看這個檢視表中的所有資料列。所有其他主體只能看到變更串流的選項，前提是 SELECT 權限已授予目前的資料庫角色、目前資料庫角色所屬的角色，或 public。

資料欄名稱 類型 說明
CHANGE_STREAM_CATALOG STRING 變更串流的目錄名稱。一律為空字串。
CHANGE_STREAM_SCHEMA STRING 變更串流的結構定義名稱。一律為空字串。
CHANGE_STREAM_NAME STRING 變更串流的名稱。
OPTION_NAME STRING 變更串流選項的名稱。
OPTION_TYPE STRING 變更串流選項的資料類型。
OPTION_VALUE STRING 變更串流選項值。

CHANGE_STREAM_PRIVILEGES

這個資料表已篩選資料列，列出所有變更串流授予任何資料庫角色 (包括 public) 的所有精細的存取控管權限。如果主體具備資料庫層級 IAM 權限，且有權存取 spanner_info_reader 系統角色或該角色的成員，則可查看這個檢視表中的所有資料列。所有其他主體只能查看授予變更串流的權限，這些權限會授予目前資料庫角色、目前資料庫角色所屬的角色，或 public。

資料欄名稱 類型 說明
CHANGE_STREAM_CATALOG STRING 包含變更串流的目錄名稱 (空字串)。
CHANGE_STREAM_SCHEMA STRING 包含變更串流的結構定義名稱 (空字串)。
CHANGE_STREAM_NAME STRING 變更串流的名稱。
PRIVILEGE_TYPE STRING SELECT (變更串流唯一允許的權限)。
GRANTEE STRING 獲授予這項權限的資料庫角色名稱。

ROUTINES

這個資料表已篩選資料列，列出資料庫的所有變更串流讀取函式。具備資料庫層級 IAM 權限的主體，以及獲授予 spanner_info_reader 系統角色或該角色成員存取權的主體，可以查看這個檢視表中的所有資料列。所有其他主體只能查看變更串流讀取函式，且該函式必須已將 EXECUTE 精細的存取控管權限授予下列對象：目前的資料庫角色、目前資料庫角色所屬的角色，或 public。

資料欄名稱 類型 說明
SPECIFIC_CATALOG STRING 常式的目錄名稱，一律為空字串。
SPECIFIC_SCHEMA STRING 常式的結構定義名稱。一律為空字串。
SPECIFIC_NAME STRING 日常安排的名稱。即使常式名稱超載，也能專門用於識別常式。
ROUTINE_CATALOG STRING 常式的目錄名稱，一律為空字串。
ROUTINE_SCHEMA STRING 常式的結構定義名稱。一律為空字串。
ROUTINE_NAME STRING 日常安排的名稱。(如果超載，可能會重複)。
ROUTINE_TYPE STRING 常式的類型 (FUNCTION 或 PROCEDURE)。一律為 FUNCTION
DATA_TYPE STRING 常式傳回的資料類型
ROUTINE_BODY STRING 常式主體的類型 (SQL 或 EXTERNAL)。
ROUTINE_DEFINITION STRING ROUTINE_BODY 的定義。
SECURITY_TYPE STRING 日常安排的安全類型。一律INVOKER。

ROUTINE_OPTIONS

這個資料列篩選資料表包含每個定義的異動串流讀取函式的每個選項，每個選項各有一列。

具備資料庫層級 IAM 權限的主體，以及已獲授予 spanner_info_reader 系統角色或該角色成員存取權的主體，可以查看這個檢視表中的所有資料列。所有其他主體只能查看異動串流讀取函式的選項，前提是 EXECUTE 精細存取控管權限已授予目前的資料庫角色、目前資料庫角色所屬的角色，或 public。

資料欄名稱 類型 說明
SPECIFIC_CATALOG STRING 常式的目錄名稱，一律為空字串。
SPECIFIC_SCHEMA STRING 常式的結構定義名稱。一律為空字串。
SPECIFIC_NAME STRING 日常安排的名稱。在名稱超載時，專門用於識別常式。
OPTION_NAME STRING 可明確識別選項的 SQL ID。
OPTION_TYPE STRING OPTION_VALUE 的資料類型。
OPTION_VALUE STRING 說明這個選項值的 SQL 常值。這個資料欄的值必須可剖析為查詢的一部分。

PARAMETERS

這個已篩選資料列的資料表，定義了各個變更串流讀取函式的引數。每個資料列都會說明一個變更串流讀取函式的一個引數。

具備資料庫層級 IAM 權限的主體，以及獲授予 spanner_info_reader 系統角色或該角色成員存取權的主體，可以查看這個檢視表中的所有資料列。所有其他主體只能查看變更串流讀取函式的參數，前提是 EXECUTE 精細的存取控管權限已授予下列角色：目前的資料庫角色、目前資料庫角色所屬的角色，或 public。

資料欄名稱 類型 說明
SPECIFIC_CATALOG STRING 常式的目錄名稱，一律為空字串。
SPECIFIC_SCHEMA STRING 常式的結構定義名稱。一律為空字串。
SPECIFIC_NAME STRING 日常安排的名稱。在名稱超載時，專門用於識別常式。
ORDINAL_POSITION INT64 常式中參數的序數位置，從值 1 開始。
PARAMETER_NAME STRING 參數的名稱。
DATA_TYPE STRING 參數的資料類型。
PARAMETER_DEFAULT STRING 參數的預設值，如果參數沒有預設值，則為 NULL。

ROUTINE_PRIVILEGES

這個資料列篩選資料表列出所有精細的存取控管權限，這些權限授予所有變更串流讀取函式給任何資料庫角色，包括 public。具備資料庫層級 IAM 權限的主體，以及獲授予 spanner_info_reader 系統角色或該角色成員存取權的主體，可以查看這個檢視表中的所有資料列。所有其他主體只能查看授予變更串流讀取函式的權限，這些函式會授予目前的資料庫角色、目前資料庫角色所屬的角色，或 public。

資料欄名稱 類型 說明
SPECIFIC_CATALOG STRING 常式的目錄名稱，一律為空字串。
SPECIFIC_SCHEMA STRING 常式的結構定義名稱。一律為空字串。
SPECIFIC_NAME STRING 日常安排的名稱。在名稱超載時，專門用於識別常式。
PRIVILEGE_TYPE STRING 一律EXECUTE。
GRANTEE STRING 授予這項權限的資料庫角色名稱。

ROLE_TABLE_GRANTS

這個資料列篩選資料表會列出所有資料表和檢視表上，授予任何資料庫角色 (包括 public) 的所有精細的存取控管權限。如果主體具備資料庫層級 IAM 權限，且有權存取 spanner_info_reader 系統角色或該角色的成員，則可查看這個檢視表中的所有資料列。所有其他主體只能查看授予資料表和檢視表的權限，這些權限適用於目前的資料庫角色，以及目前資料庫角色所屬的角色，但不包括 public。

資料欄名稱 類型 說明
GRANTOR STRING 未使用。一律NULL。
GRANTEE STRING 授予這項權限的資料庫角色名稱。
TABLE_CATALOG STRING 未使用。一律為空字串。
TABLE_SCHEMA STRING 未使用。一律為空字串。
TABLE_NAME STRING 資料表或檢視表的名稱。
PRIVILEGE_TYPE STRING 權限類型 (SELECT、INSERT、UPDATE 或 DELETE)。
IS_GRANTABLE STRING 未使用。一律NO。

ROLE_COLUMN_GRANTS

這個資料列篩選資料表列出授予任何資料庫角色 (包括 public) 的所有資料欄精細的存取控管權限。如果主體具備資料庫層級 IAM 權限，且有權存取 spanner_info_reader 系統角色或該角色的成員，則可查看這個檢視表中的所有資料列。所有其他主體只能查看授予目前資料庫角色的資料欄權限，以及目前資料庫角色所屬角色的資料欄權限，不包括 public。

檢視表包含 SELECT、INSERT 和 UPDATE 權限，這些權限是資料欄從包含該資料欄的資料表或檢視表繼承而來。

資料欄名稱 類型 說明
GRANTOR STRING 未使用。一律NULL。
GRANTEE STRING 授予這項權限的資料庫角色名稱。
TABLE_CATALOG STRING 未使用。一律為空字串。
TABLE_SCHEMA STRING 未使用。一律為空字串。
TABLE_NAME STRING 資料表或檢視表的名稱，其中包含資料欄。
COLUMN_NAME STRING 獲授予權限的資料欄名稱。
PRIVILEGE_TYPE STRING 權限類型 (SELECT、INSERT 或 UPDATE)。
IS_GRANTABLE STRING 未使用。一律NO。

ROLE_CHANGE_STREAM_GRANTS

這個資料列篩選資料表列出授予所有異動串流的 SELECT 權限，適用於任何資料庫角色，包括 public。如果主體具備資料庫層級 IAM 權限，且有權存取 spanner_info_reader 系統角色或該角色的成員，則可查看這個檢視表中的所有資料列。所有其他主體只能查看授予目前資料庫角色，以及目前資料庫角色所屬角色的變更串流權限，不包括 public。

資料欄名稱 類型 說明
CHANGE_STREAM_CATALOG STRING 未使用。一律為空字串。
CHANGE_STREAM_SCHEMA STRING 包含變更串流的結構定義名稱。
CHANGE_STREAM_NAME STRING 變更串流的名稱。
PRIVILEGE_TYPE STRING 權限類型 (僅限 SELECT)。
GRANTEE STRING 授予這項權限的資料庫角色名稱。

ROLE_MODEL_GRANTS

這個資料列篩選資料表會列出所有模型上，授予任何資料庫角色 (包括 public) 的所有精細的存取控管權限。如果主體具備資料庫層級 IAM 權限，且有權存取 spanner_info_reader 系統角色或該角色的成員，則可查看這個檢視表中的所有資料列。所有其他主體只能查看授予資料表和檢視表的權限，這些權限適用於目前的資料庫角色，以及目前資料庫角色所屬的角色，但不包括 public。

資料欄名稱 類型 說明
GRANTOR STRING 未使用。一律NULL。
GRANTEE STRING 授予這項權限的資料庫角色名稱。
MODEL_CATALOG STRING 未使用。一律為空字串。
MODEL_SCHEMA STRING 未使用。一律為空字串。
MODEL_NAME STRING 模型名稱。
PRIVILEGE_TYPE STRING 權限類型 (EXECUTE)。
IS_GRANTABLE STRING 未使用。一律NO。

ROLE_ROUTINE_GRANTS

這個資料表已篩選資料列，列出授予任何資料庫角色 (包括 public) 的所有異動串流讀取函式 EXECUTE 權限。具備 IAM 資料庫層級權限的主體，以及有權存取 spanner_info_reader 系統角色或該角色成員的主體，可以查看這個檢視表中的所有資料列。所有其他主體只能查看授予變更串流讀取函式的權限，這些函式屬於目前的資料庫角色，以及目前資料庫角色所屬的角色，不包括 public。

資料欄名稱 類型 說明
GRANTOR STRING 未使用。一律NULL。
GRANTEE STRING 獲授予權限的角色名稱。
SPECIFIC_CATALOG STRING 日常安排目錄的名稱。
SPECIFIC_SCHEMA STRING 常式結構定義的名稱。
SPECIFIC_NAME STRING 日常安排的名稱。在名稱超載時，專門用於識別常式。
PRIVILEGE_TYPE STRING 授予的權限類型。一律EXECUTE。
IS_GRANTABLE STRING 未使用。一律NO。

MODELS

這個資料表會列出資料庫的所有模型。

資料欄名稱 類型 說明
MODEL_CATALOG STRING 目錄的名稱。一律為空字串。
MODEL_SCHEMA STRING 這個模型的結構定義名稱。一律為空字串。
MODEL_NAME STRING 模型名稱。
IS_REMOTE BOOL 如果這是遠端模型，則為 TRUE。如果這是代管模型，則為 FALSE。

MODEL_OPTIONS

這個表格包含模型的設定選項。

資料欄名稱 類型 說明
MODEL_CATALOG STRING 目錄的名稱。一律為空字串。
MODEL_SCHEMA STRING 這個模型的結構定義名稱。一律為空字串。
MODEL_NAME STRING 模型名稱。
OPTION_NAME STRING 模型選項的名稱。
OPTION_TYPE STRING 模型選項的資料類型。
OPTION_VALUE STRING 模型選項值。

MODEL_COLUMNS

這個表格列出模型中的資料欄。

資料欄名稱 類型 說明
MODEL_CATALOG STRING 目錄的名稱。一律為空字串。
MODEL_SCHEMA STRING 這個模型的結構定義名稱。一律為空字串。
MODEL_NAME STRING 模型名稱。
COLUMN_KIND STRING 模型資料欄種類。"INPUT" 或 "OUTPUT"。
COLUMN_NAME STRING 資料欄的名稱。
DATA_TYPE STRING 資料欄的標準 SQL 資料類型。
ORDINAL_POSITION INT64 資料欄的序數位置，從值 1 開始，用於保留宣告資料欄的順序。
IS_EXPLICIT BOOL 如果資料欄是在 DDL 中明確指定，則為 TRUE；如果資料欄是從端點探索而來，則為 FALSE。

MODEL_COLUMN_OPTIONS

這個表格包含模型資料欄的設定選項。

資料欄名稱 類型 說明
MODEL_CATALOG STRING 目錄的名稱。一律為空字串。
MODEL_SCHEMA STRING 這個模型的結構定義名稱。一律為空字串。
MODEL_NAME STRING 模型名稱。
COLUMN_KIND STRING 模型資料欄種類。"INPUT" 或 "OUTPUT"。
COLUMN_NAME STRING 資料欄的名稱。
OPTION_NAME STRING 模型資料欄選項的名稱。
OPTION_TYPE STRING 模型資料欄選項的資料類型。
OPTION_VALUE STRING 模型資料欄選項值。

MODEL_PRIVILEGES

這個資料列篩選資料表列出在模型層級授予資料庫角色的所有權限，包括 public。具備資料庫層級 IAM 權限的主體，以及有權存取 spanner_info_reader 系統角色或該角色成員的主體，可以查看這個檢視表中的所有資料列。所有其他主體只能查看模型權限，前提是目前資料庫角色、目前資料庫角色所屬的角色，或 public 具備該模型的 EXECUTE 精細存取控管權限。

資料欄名稱 類型 說明
MODEL_CATALOG STRING 未使用。一律為空字串。
MODEL_SCHEMA STRING 未使用。一律為空字串。
MODEL_NAME STRING 授予精細的存取控管權限的模型名稱。
PRIVILEGE_TYPE STRING EXECUTE>
GRANTEE STRING 授予這項權限的資料庫角色名稱。

PROPERTY_GRAPHS

這個資料列篩選資料表會列出資料庫中的屬性圖。具備資料庫層級 IAM 權限的主體，以及具備 spanner_info_reader 系統角色或該角色成員存取權的主體，可以查看這個檢視表中的所有資料列。所有其他主體必須符合查看所有資料表的規定，才能查看用於定義這些圖表的屬性圖。

資料欄名稱 類型 說明
PROPERTY_GRAPH_CATALOG STRING 目錄的名稱。一律為空字串。
PROPERTY_GRAPH_SCHEMA STRING 結構定義的名稱。如果未命名，則為空白字串。
PROPERTY_GRAPH_NAME STRING 屬性圖的名稱。
PROPERTY_GRAPH_METADATA_JSON JSON JSON 格式的屬性圖定義。

PROPERTY_GRAPH_METADATA_JSON 欄包含 PropertyGraph JSON 物件，定義如下：

JSON 物件名稱 欄位名稱 JSON 類型 說明
PropertyGraph catalog string 目錄的名稱。一律為空字串。
schema string 結構定義的名稱。如果未命名，則為空白字串。
name string 屬性圖的名稱。
nodeTables array<object> 節點的 GraphElementTable 物件清單。
edgeTables array<object> 邊緣的 GraphElementTable 物件清單。
labels array<object> GraphElementLabel 物件清單。
propertyDeclarations array<object> GraphPropertyDeclaration 物件清單。
GraphElementTable name string 圖表元素資料表的名稱。
kind string NODE 或 EDGE。
baseCatalogName string 基礎資料表所在目錄的名稱。
baseSchemaName string 基礎資料表所在結構定義的名稱。
baseTableName string 用於建立元素的輸入資料表名稱。
keyColumns array<string> 構成元素索引鍵的資料欄名稱。
labelNames array<string> 附加至這個元素資料表的標籤名稱。
propertyDefinitions array<object> GraphPropertyDefinition 物件清單。
dynamicLabelExpr string 包含 DYNAMIC LABEL 定義的資料欄名稱。
dynamicPropertyExpr string 包含 DYNAMIC PROPERTIES 定義的資料欄名稱。
sourceNodeTable object GraphNodeTableReference 物件。只有在 kind 為 EDGE 時才會存在。
destinationNodeTable object GraphNodeTableReference 物件。只有在 kind 為 EDGE 時才會存在。
GraphNodeTableReference nodeTableName string 圖表元素資料表的名稱。
edgeTableColumns array<string> 與邊的來源和目的地鍵相關聯的資料欄名稱。
nodeTableColumns array<string> 與節點來源和目的地鍵相關聯的資料欄名稱。
GraphElementLabel name string 標籤名稱。
propertyDeclarationNames array<string> 與這個標籤相關聯的屬性名稱。
GraphPropertyDeclaration name string 屬性的名稱。
type string 屬性的類型。
GraphPropertyDefinition propertyDeclarationName string 屬性的名稱。
valueExpressionSql string 定義屬性的運算式。

範例

傳回使用者結構定義中每個資料表的相關資訊：

SELECT
  t.table_schema,
  t.table_name,
  t.parent_table_name
FROM
  information_schema.tables AS t
WHERE
  t.table_catalog = ''
  AND
  t.table_schema NOT IN ('information_schema', 'SPANNER_SYS')
  AND t.table_type = 'BASE TABLE'
ORDER BY
  t.table_catalog,
  t.table_schema,
  t.table_name

傳回 INFORMATION_SCHEMA 中所有資料表的名稱：

SELECT
  t.table_name
FROM
  information_schema.tables AS t
WHERE
  t.table_schema = "SPANNER_SYS"

傳回預設結構定義中使用者資料表 MyTable 的資料欄資訊：

SELECT
  t.column_name,
  t.spanner_type,
  t.is_nullable
FROM
  information_schema.columns AS t
WHERE
  t.table_catalog = ''
  AND
  t.table_schema = ''
  AND
  t.table_name = 'MyTable'
ORDER BY
  t.table_catalog,
  t.table_schema,
  t.table_name,
  t.ordinal_position

傳回資料庫預設主要區域的資訊。如果未設定預設主要區域，則會傳回空白：

SELECT
  s.option_name,
  s.option_value
FROM
  information_schema.database_options s
WHERE
  s.option_name = 'default_leader'

傳回使用者結構定義中每個索引的相關資訊：

SELECT
  t.table_schema,
  t.table_name,
  t.index_name,
  t.parent_table_name
FROM
  information_schema.indexes AS t
WHERE
  t.table_catalog = ''
  AND
  t.table_schema NOT IN ('information_schema', 'SPANNER_SYS')
  AND
  t.index_type != 'PRIMARY_KEY'
ORDER BY
  t.table_catalog,
  t.table_schema,
  t.table_name,
  t.index_name

傳回所有使用預設值以外選項的資料欄：

SELECT
  t.table_schema,
  t.table_name,
  t.column_name,
  t.option_type,
  t.option_value,
  t.option_name
FROM
  information_schema.column_options AS t
WHERE
  t.table_catalog = ''
AND
  t.table_schema NOT IN ('information_schema', 'SPANNER_SYS')

傳回目前的最佳化工具相關資料庫選項：

SELECT
  s.option_name,
  s.option_value
FROM
  information_schema.database_options s
WHERE
  s.schema_name=''
  AND s.option_name IN ('optimizer_version',
    'optimizer_statistics_package')

傳回所有可用的統計資料套件：

SELECT
  *
FROM
  information_schema.spanner_statistics;

傳回所有序列：

SELECT
  *
FROM
  information_schema.sequences;

傳回名為「MySequence」的序列的所有序列選項

SELECT
  *
FROM
  information_schema.sequence_options WHERE name="MySequence";

傳回所有屬性圖的名稱和定義：

SELECT
  property_graph_name,
  property_graph_metadata_json
FROM
  information_schema.property_graphs

傳回所有屬性圖的名稱，以及其標籤和屬性：

SELECT
  property_graph_name,
  property_graph_metadata_json.labels,
  property_graph_metadata_json.propertyDeclarations
FROM
  information_schema.property_graphs

後續步驟