Monitorize fichas

Como fornecedor de dados, pode acompanhar as métricas de utilização das suas fichas. Existem dois métodos para obter as métricas de utilização dos seus dados partilhados:

  • Use a partilha do BigQuery (anteriormente Analytics Hub). Com a partilha, pode ver o painel de controlo de métricas de utilização das suas fichas, que inclui subscrições diárias, tarefas executadas diariamente, número de subscritores de cada organização e frequência de tarefas de cada tabela. As métricas de utilização dos seus dados partilhados são obtidas através da consulta da vista INFORMATION_SCHEMA.SHARED_DATASET_USAGE.

  • Use a vista INFORMATION_SCHEMA. Pode acompanhar a forma como os subscritores usam os seus conjuntos de dados consultando diretamente a vista INFORMATION_SCHEMA.SHARED_DATASET_USAGE.

Utilize a partilha

Para obter as métricas de utilização dos seus dados partilhados através da partilha, siga estes passos:

  1. Na Google Cloud consola, aceda à página Partilha (Analytics Hub).

    Aceda à partilha (Analytics Hub)

  2. Clique no nome da troca de dados que contém a ficha para a qual quer ver as métricas de utilização.

  3. Clique em Métricas de utilização e, de seguida, faça o seguinte:

    1. No menu Fichas, selecione a ficha.

    2. Defina o intervalo de tempo.

A página apresenta as seguintes métricas de utilização:

  • Total de subscrições: o número de subscrições atuais na ficha selecionada. Pode ver o total de subscrições durante um período máximo de 60 dias.
  • Total de subscritores: o número de subscritores únicos em todas as subscrições na ficha selecionada. Pode ver o número total de subscritores durante um período máximo de 60 dias.
  • Total de tarefas executadas: o número de tarefas únicas executadas em cada tabela da ficha selecionada.
  • Total de bytes analisados: o número total de bytes analisados de todas as tabelas da ficha selecionada.
  • Subscrições diárias: o gráfico que acompanha o número de subscrições da ficha selecionada durante um período. Pode ver as subscrições diárias durante um período máximo de 60 dias.
  • Subscritores por organização: apresenta as organizações e o respetivo número de subscritores que consomem a sua ficha selecionada.
  • Tarefas executadas diariamente: este gráfico apresenta o consumo de tarefas da ficha selecionada.
  • Frequência da tarefa das tabelas: a frequência com que as tabelas são acedidas na ficha selecionada.

Use a vista INFORMATION_SCHEMA

Se for um fornecedor de dados, pode acompanhar a forma como os subscritores usam os seus conjuntos de dados consultando a vista INFORMATION_SCHEMA.SHARED_DATASET_USAGE. Certifique-se de que tem a função necessária para consultar esta vista.

Para executar a consulta num projeto que não seja o seu projeto predefinido, adicione o ID do projeto no seguinte formato:

PROJECT_ID.region-REGION_NAME.INFORMATION_SCHEMA.SHARED_DATASET_USAGE

Por exemplo, myproject.region-us.INFORMATION_SCHEMA.SHARED_DATASET_USAGE.

Os exemplos seguintes descrevem como ver as métricas de utilização consultando a vista INFORMATION_SCHEMA:

Obter o número total de tarefas executadas em todas as tabelas partilhadas

O exemplo seguinte calcula o total de tarefas executadas pelos subscritores de um projeto:

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

O resultado é semelhante ao seguinte:

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

Para verificar o total de tarefas executadas pelos subscritores, use a cláusula WHERE:

  • Para conjuntos de dados, use WHERE dataset_id = "...".
  • Para tabelas, use WHERE dataset_id = "..." AND table_id = "...".

Obtenha a tabela mais usada com base no número de linhas processadas

A seguinte consulta calcula a tabela mais usada com base no número de linhas processadas pelos subscritores.

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

O resultado é semelhante ao seguinte:

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

Encontre as principais organizações que consomem as suas tabelas

A seguinte consulta calcula os principais subscritores com base no número de bytes processados das suas tabelas. Também pode usar a coluna num_rows_processed como uma métrica.

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

O resultado é semelhante ao seguinte:

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

Para subscritores sem uma organização, pode usar job_project_number em vez de subscriber_org_number.

Aceda às métricas de utilização da sua troca de dados

Se a sua troca de dados e conjunto de dados de origem estiverem em projetos diferentes, siga estes passos para ver as métricas de utilização da sua troca de dados:

  1. Encontre todas as fichas que pertencem à sua troca de dados.
  2. Recuperar o conjunto de dados de origem anexado à ficha.
  3. Para ver as métricas de utilização da sua troca de dados, use a seguinte consulta:
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"

O que se segue?