監控房源

資料供應商可以追蹤房源的使用量指標。如要取得共用資料的使用情況指標,有以下兩種方法:

  • 使用 BigQuery sharing (舊稱 Analytics Hub)。透過「共用」功能,您可以查看房源的用量指標資訊主頁,包括每日訂閱數、每日執行的工作數、各機構的訂閱者人數,以及各資料表的作業頻率。如要擷取共用資料的用量指標,請查詢 INFORMATION_SCHEMA.SHARED_DATASET_USAGE 檢視畫面。

  • 使用 INFORMATION_SCHEMA 檢視畫面。您可以直接查詢 INFORMATION_SCHEMA.SHARED_DATASET_USAGE 檢視畫面,追蹤訂閱者使用資料集的方式。

使用分享功能

如要使用「共用」取得共用資料的用量指標,請按照下列步驟操作:

  1. 前往 Google Cloud 控制台的「Sharing (Analytics Hub)」(共用 (Analytics Hub)) 頁面。

    前往「共用」(Analytics Hub)

  2. 按一下包含要查看使用情況指標的商家資訊的資料交換名稱。

  3. 按一下「用量指標」,然後執行下列操作:

    1. 從「房源」選單中選取房源。

    2. 設定時間範圍。

這個頁面會顯示下列使用情況指標:

  • 訂閱總數:所選房源目前的訂閱數。最多可查看 60 天的總訂閱數。
  • 訂閱總人數:所選項目所有訂閱方案的不重複訂閱者人數。最多可查看 60 天的總訂閱人數。
  • 執行的工作總數:在所選目錄的每個資料表上執行的不重複工作數量。
  • 掃描的總位元組數:從所選項目所有資料表掃描的總位元組數。
  • 每日訂閱次數:這張圖表會追蹤指定時間範圍內,所選房源的訂閱次數。最多可查看 60 天的每日訂閱資料。
  • 各機構的訂閱人數:列出機構和訂閱人數,這些訂閱者會使用您選取的項目。
  • 每日執行的工作:這個圖表會顯示所選項目消耗的工作量。
  • 資料表的工作頻率:在所選項目中存取資料表的頻率。

使用 INFORMATION_SCHEMA 檢視畫面

資料供應商可以查詢 INFORMATION_SCHEMA.SHARED_DATASET_USAGE 檢視畫面,追蹤訂閱者使用資料集的方式。請確認您具備查詢這個檢視畫面的必要角色。

如要對預設專案以外的專案執行查詢,請使用以下格式新增專案 ID:

PROJECT_ID.region-REGION_NAME.INFORMATION_SCHEMA.SHARED_DATASET_USAGE

例如 myproject.region-us.INFORMATION_SCHEMA.SHARED_DATASET_USAGE

下列範例說明如何查詢 INFORMATION_SCHEMA 檢視畫面,查看用量指標:

取得所有共用資料表上執行的工作總數

以下範例會計算專案中訂閱者執行的工作總數:

SELECT
  COUNT(DISTINCT job_id) AS num_jobs
FROM
  `region-us`.INFORMATION_SCHEMA.SHARED_DATASET_USAGE

結果會類似如下:

+------------+
| num_jobs   |
+------------+
| 1000       |
+------------+

如要查看訂閱者執行的工作總數,請使用 WHERE 子句:

  • 如果是資料集,請使用 WHERE dataset_id = "..."
  • 表格請使用 WHERE dataset_id = "..." AND table_id = "..."

根據處理的列數,找出最常使用的資料表

下列查詢會根據訂閱者處理的資料列數,計算最常使用的資料表。

SELECT
  dataset_id,
  table_id,
  SUM(num_rows_processed) AS usage_rows
FROM
  `region-us`.INFORMATION_SCHEMA.SHARED_DATASET_USAGE
GROUP BY
  1,
  2
ORDER BY
  3 DESC
LIMIT
  1

輸出結果會與下列內容相似:

+---------------+-------------+----------------+
| dataset_id    | table_id      | usage_rows     |
+---------------+-------------+----------------+
| mydataset     | mytable     | 15             |
+---------------+-------------+----------------+

找出最常使用資料表的機構

下列查詢會根據資料表處理的位元組數,計算出最常使用的訂閱者。您也可以將 num_rows_processed 資料欄做為指標。

SELECT
  subscriber_org_number,
  ANY_VALUE(subscriber_org_display_name) AS subscriber_org_display_name,
  SUM(total_bytes_processed) AS usage_bytes
FROM
  `region-us`.INFORMATION_SCHEMA.SHARED_DATASET_USAGE
GROUP BY
  1

輸出結果會與下列內容相似:

+--------------------------+--------------------------------+----------------+
|subscriber_org_number     | subscriber_org_display_name    | usage_bytes    |
+-----------------------------------------------------------+----------------+
| 12345                    | myorganization                 | 15             |
+--------------------------+--------------------------------+----------------+

如果訂閱者沒有機構,可以使用 job_project_number,而非 subscriber_org_number

取得資料交換的使用情況指標

如果資料交易所和來源資料集位於不同專案,請按照下列步驟查看資料交易所的使用情況指標:

  1. 找出資料交易平台的所有刊登項目
  2. 擷取附加至房源資訊的來源資料集。
  3. 如要查看資料交易所的用量指標,請使用下列查詢:
SELECT
  *
FROM
  source_project_1.`region-us`.INFORMATION_SCHEMA.SHARED_DATASET_USAGE
WHERE
  dataset_id='source_dataset_id'
AND data_exchange_id="projects/4/locations/us/dataExchanges/x1"
UNION ALL
SELECT
  *
FROM
  source_project_2.`region-us`.INFORMATION_SCHEMA.SHARED_DATASET_USAGE
WHERE
  dataset_id='source_dataset_id'
AND data_exchange_id="projects/4/locations/us/dataExchanges/x1"

取得共用檢視畫面的用量指標

下列查詢會顯示專案中所有共用檢視區塊的用量指標:

SELECT
  project_id,
  dataset_id,
  table_id,
  num_rows_processed,
  total_bytes_processed,
  shared_resource_id,
  shared_resource_type,
  referenced_tables
FROM `myproject`.`region-us`.INFORMATION_SCHEMA.SHARED_DATASET_USAGE
WHERE shared_resource_type = 'VIEW'

輸出結果會與下列內容相似:

+---------------------+----------------+----------+--------------------+-----------------------+--------------------+----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|     project_id      |   dataset_id   | table_id | num_rows_processed | total_bytes_processed | shared_resource_id | shared_resource_type |                                                                                                              referenced_tables                                                                                                              |
+---------------------+----------------+----------+--------------------+-----------------------+--------------------+----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|     myproject       | source_dataset | view1    |                  6 |                    38 | view1              | VIEW                 | [{"project_id":"myproject","dataset_id":"source_dataset","table_id":"test_table","processed_bytes":"21"},
{"project_id":"bq-dataexchange-exp","dataset_id":"other_dataset","table_id":"other_table","processed_bytes":"17"}]                 |

+---------------------+----------------+----------+--------------------+-----------------------+--------------------+----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+

取得共用資料表值函式的用量指標

下列查詢會顯示專案中所有共用資料表值函式的使用量指標:

SELECT
  project_id,
  dataset_id,
  table_id,
  num_rows_processed,
  total_bytes_processed,
  shared_resource_id,
  shared_resource_type,
  referenced_tables
FROM `myproject`.`region-us`.INFORMATION_SCHEMA.SHARED_DATASET_USAGE
WHERE shared_resource_type = 'TABLE_VALUED_FUNCTION'

輸出結果會與下列內容相似:

+---------------------+----------------+----------+--------------------+-----------------------+--------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------+
|     project_id      |   dataset_id   | table_id | num_rows_processed | total_bytes_processed | shared_resource_id | shared_resource_type  |                                                  referenced_tables                                                  |
+---------------------+----------------+----------+--------------------+-----------------------+--------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------+
|     myproject       | source_dataset |          |                  3 |                    45 | provider_exp       | TABLE_VALUED_FUNCTION | [{"project_id":"myproject","dataset_id":"source_dataset","table_id":"test_table","processed_bytes":"45"}]           |
+---------------------+----------------+----------+--------------------+-----------------------+--------------------+-----------------------+---------------------------------------------------------------------------------------------------------------------+

後續步驟