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

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

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

  SELECT
    table_name
  FROM
    information_schema.tables
  WHERE
    table_schema = ''

精細存取權控管機制的使用者會根據資料庫角色，看到部分 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 中的資料表

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

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 轉換後略過範圍的最大值。

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 系統角色存取權或該角色成員存取權的主體，都可以查看這個檢視畫面中的所有資料列。其他所有實體只能查看 SELECT、INSERT、UPDATE 或 DELETE 精細存取控制權限授予目前資料庫角色、目前資料庫角色所屬的角色，或是 public 的資料表的權限。

資料欄名稱 類型 說明
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 如果限制是 資訊 (NOT ENFORCED) 外鍵，則為 NO。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 外鍵參照的 PRIMARY KEY 或 UNIQUE 限制條件的結構定義名稱。如果未命名，則為空字串。
UNIQUE_CONSTRAINT_NAME STRING FOREIGN KEY 參照的主鍵或 UNIQUE 限制條件名稱。
MATCH_OPTION STRING 一律為 SIMPLE。
UPDATE_RULE STRING 一律為 NO ACTION。
DELETE_RULE STRING CASCADE 或 NO ACTION。
SPANNER_STATE STRING 外鍵的目前狀態。在建立外鍵的支援索引並回填資料之前，Spanner 不會開始強制執行限制。索引就緒後，Spanner 就會開始針對新交易強制執行限制，同時驗證現有資料。可能的值和這些值代表的狀態如下：
  • BACKFILLING_INDEXES：正在補充索引。
  • VALIDATING_DATA：系統正在驗證現有資料和新寫入的資料。
  • WAITING_FOR_COMMIT：外部鍵大量操作已成功完成，或不需要執行任何操作，但外部鍵仍處於待處理狀態。
  • COMMITTED：已提交結構定義變更。

CHECK_CONSTRAINTS

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

資料欄名稱 類型 說明
CONSTRAINT_CATALOG STRING 限制項目錄的名稱。這個資料欄絕不會是 Null 值，但一律是空白字串。
CONSTRAINT_SCHEMA STRING 限制的結構定義名稱。如果未命名，則為空字串。
CONSTRAINT_NAME STRING 限制的名稱。這個資料欄絕不會是 Null 值。如果未在結構定義中明確指定，系統會指派系統定義的名稱。
CHECK_CLAUSE STRING CHECK 限制條件的運算式。這個資料欄絕不會是 Null 值。
SPANNER_STATE STRING CHECK 限制條件的目前狀態。這個資料欄絕不會是 Null 值。可能的狀態如下：
  • 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 受限資料欄的結構定義名稱。這個資料欄絕不會是 Null 值。如果未命名，則為空字串。
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 資料欄表的結構定義名稱。這個資料欄絕不會是 Null 值。如果未命名，則為空字串。
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 開始。如果是鍵資料欄，這個值為 NULL；如果是非鍵資料欄 (例如索引的 STORING 子句中指定的資料欄)，這個值為 NULL。
COLUMN_ORDERING STRING 資料欄的排序。如果是鍵資料欄，這個值為 ASC 或 DESC；如果是非鍵資料欄 (例如索引的 STORING 子句中指定的資料欄)，這個值為 NULL。
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 識別碼。這個識別碼是 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 系統角色或該角色成員存取權的主體，都可以查看這個檢視畫面中的所有資料列。其他所有主體只能查看授予目前資料庫角色的角色成員資格，或是目前資料庫角色所屬角色的成員資格。

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

資料欄名稱 類型 說明
ROLE_NAME STRING 授予此會員資格的資料庫角色名稱。
GRANTEE STRING 授予此會員資格的資料庫角色名稱。

CHANGE_STREAMS

這個已篩選資料列的表格會列出資料庫的所有變更串流，並註明哪些串流會追蹤整個資料庫，而非特定表格或欄。擁有資料庫層級 IAM 權限的主體，以及已授予 spanner_info_reader 系統角色存取權或該角色成員存取權的主體，都可以查看這個檢視畫面中的所有資料列。其他所有主體只能查看變更串流，其中 SELECT 精細存取權限已授予目前資料庫角色、目前資料庫角色所屬的角色，或 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 系統角色存取權或該角色成員存取權的主體，都可以查看這個檢視畫面中的所有資料列。其他所有主體只能查看變更資料流的資料列，這些資料流是將 SELECT 權限授予目前資料庫角色、目前資料庫角色所屬的角色，或是 public 的情況。

資料欄名稱 類型 說明
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 識別碼。
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

這個已篩選列的表格會列出所有變更串流中授予任何資料庫角色 (包括 public) 的 SELECT 權限。擁有資料庫層級 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 系統角色存取權或該角色成員存取權的主體，都可以查看這個檢視畫面中的所有資料列。其他所有主體只能查看模型的權限，這些模型會將 EXECUTE 精細存取權限授予目前資料庫角色、目前資料庫角色所屬的角色，或 public。

資料欄名稱 類型 說明
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 物件的清單。
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_name,
  t.parent_table_name
FROM
  information_schema.tables AS t
WHERE
  t.table_catalog = ''
  AND
  t.table_schema = ''
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_name,
  t.index_name,
  t.parent_table_name
FROM
  information_schema.indexes AS t
WHERE
  t.table_catalog = ''
  AND
  t.table_schema = ''
  AND
  t.index_type != 'PRIMARY_KEY'
ORDER BY
  t.table_catalog,
  t.table_schema,
  t.table_name,
  t.index_name

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

SELECT
  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 = ''

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

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

後續步驟

  • 瞭解可用的內省工具，協助您調查資料庫問題。