資料欄作業統計資料

Spanner 提供內建資料表，可記錄資料表欄的讀取、查詢和寫入作業統計資料。您可以使用資料欄作業統計資料執行下列操作：

• 找出讀取、查詢和寫入流量超出預期的資料欄。

• 找出使用率高的資料欄。

無論存取的資料列數量為何，只要您查詢或寫入資料欄，Spanner 就會將該資料欄的對應作業計數加 1。

您可以透過每秒作業數、每秒作業數 (依 API 方法) 等指標，以及系統洞察圖表中的其他相關指標，監控資料庫的整體狀況。

存取資料欄作業統計資料

Spanner 會在 SPANNER_SYS 結構定義中提供資料欄作業統計資料。您可以透過下列方式存取 SPANNER_SYS 資料：

• 資料庫在 Google Cloud 控制台中的 Spanner Studio 頁面

• gcloud spanner databases execute-sql 指令

• executeSql 或 executeStreamingSql 方法。

Spanner 提供的下列單一讀取方法不支援 SPANNER_SYS：

• 從資料表中的單一資料列或多個資料列執行強式讀取。
• 從資料表中的單一資料列或多個資料列執行過時讀取。
• 從次要索引中的單一資料列或多個資料列讀取。

詳情請參閱「單一讀取方法」。

資料欄作業統計資料

下列資料表會追蹤特定時間範圍內，資料欄的讀取、查詢和寫入統計資料：

• SPANNER_SYS.COLUMN_OPERATIONS_STATS_MINUTE：1 分鐘間隔內的作業
• SPANNER_SYS.COLUMN_OPERATIONS_STATS_10MINUTE：10 分鐘間隔期間內的操作
• SPANNER_SYS.COLUMN_OPERATIONS_STATS_HOUR：每隔 1 小時的作業

這些資料表具備下列屬性：

• 每個資料表都包含資料表名稱所指定的非重疊時間間隔長度的資料。

• 1 分鐘間隔的開始時間是目前這一分鐘、10 分鐘間隔的開始時間是目前這個小時的每 10 分鐘，而 1 小時間隔的開始時間是目前這個小時。

  舉例來說，在上午 11:59:30，SQL 查詢可存取下列最近間隔：

  • 1 分鐘：上午 11:58:00–11:58:59
  • 10 分鐘：上午 11:40:00–11:49:59
  • 1 小時：上午 10:00:00–10:59:59

所有資料欄作業統計資料表的結構定義

資料欄名稱	類型	說明
INTERVAL_END	TIMESTAMP	收集欄使用統計資料的時間間隔結束時間。
TABLE_NAME	STRING	資料表或索引的名稱。
COLUMN_NAME	STRING	資料欄名稱。
READ_COUNT	INT64	從資料欄讀取的次數。
QUERY_COUNT	INT64	從資料欄讀取的查詢次數。
WRITE_COUNT	INT64	寫入資料表的查詢數。
IS_QUERY_CACHE_MEMORY_CAPPED	BOOL	統計資料收集是否因記憶體壓力而受到限制。

如果您使用變異將資料插入資料庫，Spanner 會針對插入陳述式存取的每個資料表，將 WRITE_COUNT 遞增 1。此外，如果查詢存取索引時未掃描基礎資料表，則只會遞增索引的 QUERY_COUNT。

資料保留

Spanner 至少會在下列時間範圍保留每個資料表的資料：

• SPANNER_SYS.COLUMN_OPERATIONS_STATS_MINUTE：涵蓋前六個小時的間隔。

• SPANNER_SYS.COLUMN_OPERATIONS_STATS_10MINUTE：涵蓋前四天的間隔。

• SPANNER_SYS.COLUMN_OPERATIONS_STATS_HOUR：涵蓋前 30 天的間隔。

注意： 您無法禁止 Spanner 收集資料欄作業統計資料。如要刪除這些資料表中的資料，您必須刪除與資料表關聯的資料庫，或等候 Spanner 在資料保留期限結束後移除資料。

查詢範例

本節包含多個範例 SQL 陳述式，可擷取匯總的資料欄作業統計資料。您可以使用用戶端程式庫或 Google Cloud CLI 執行這些 SQL 陳述式。

查詢最近時間間隔內寫入作業次數最多的資料表欄

GoogleSQL

    SELECT interval_end,
          table_name,
          column_name,
          write_count
    FROM spanner_sys.column_operations_stats_minute
    WHERE interval_end = (
          SELECT MAX(interval_end)
          FROM spanner_sys.column_operations_stats_minute)
    ORDER BY write_count DESC;

PostgreSQL

    SELECT interval_end,
          table_name,
          column_name,
          write_count
    FROM spanner_sys.column_operations_stats_minute
    WHERE interval_end = (
          SELECT MAX(interval_end)
          FROM spanner_sys.column_operations_stats_minute)
    ORDER BY write_count DESC;

查詢最近時間間隔內查詢作業最多的資料欄

GoogleSQL

    SELECT interval_end,
          table_name,
          column_name,
          query_count
    FROM spanner_sys.column_operations_stats_minute
    WHERE interval_end = (
          SELECT MAX(interval_end)
          FROM spanner_sys.column_operations_stats_minute)
    ORDER BY query_count DESC;

PostgreSQL

    SELECT interval_end,
          table_name,
          column_name,
          query_count
    FROM spanner_sys.column_operations_stats_minute
    WHERE interval_end = (
          SELECT MAX(interval_end)
          FROM spanner_sys.column_operations_stats_minute)
    ORDER BY query_count DESC;

查詢過去 6 小時內資料欄的使用情形

GoogleSQL

    SELECT interval_end,
          read_count,
          query_count,
          write_count
    FROM spanner_sys.column_operations_stats_minute
    WHERE table_name = "table_name"
          AND column_name = "column_name"
    ORDER BY interval_end DESC;
    

其中：

• table_name 必須是資料庫中現有的資料表或索引。
• 「column_name」必須是表格中的現有資料欄。

PostgreSQL

    SELECT interval_end,
          read_count,
          query_count,
          write_count
    FROM spanner_sys.column_operations_stats_minute
    WHERE table_name = 'table_name'
          AND column_name = 'column_name'
    ORDER BY interval_end DESC;
    

其中：

• table_name 必須是資料庫中現有的資料表或索引。
• 「column_name」必須是表格中的現有資料欄。

查詢過去 14 天的資料欄使用情形

GoogleSQL

SELECT interval_end,
       read_count,
       query_count,
       write_count
FROM spanner_sys.column_operations_stats_hour
WHERE interval_end > TIMESTAMP_ADD(CURRENT_TIMESTAMP(), INTERVAL -14 DAY)
      AND table_name = "table_name"
      AND column_name = "column_name"
ORDER BY interval_end DESC;

請將下列項目改為對應的值：

• table_name：資料庫中的資料表或索引名稱。
• column_name：資料表中的資料欄名稱。

PostgreSQL

SELECT interval_end,
   read_count,
   query_count,
   write_count
FROM spanner_sys.column_operations_stats_hour
WHERE interval_end > spanner.timestamptz_subtract(now(), '14 DAY')
  AND table_name = 'table_name'
  AND column_name = 'column_name'
ORDER BY interval_end DESC;

請將下列項目改為對應的值：

• table_name：資料庫中的資料表或索引名稱。
• column_name：資料表中的資料欄名稱。

後續步驟

• 瞭解其他內建統計資料表。

• 進一步瞭解 Spanner 適用的 SQL 最佳做法。