Comparteix via

Referencia de la tabla de sistema de historial de materialización de Delta Sharing

La tabla de historial de datos materializados compartidos representa las materializaciones de datos creadas a partir de vistas compartidas, vistas materializadas y tablas de streaming mediante Delta Sharing. Contiene información sobre la procedencia de los datos, el securable que se está materializando y cuándo se creó la materialización.

Para obtener más información sobre las materializaciones compartidas, vea Agregar vistas a un recurso compartido y Leer vistas compartidas.

Ruta de la tabla: esta tabla del sistema se encuentra en system.sharing.materialization_history.

Habilitación del materialization_history esquema

Un administrador de cuenta debe habilitar el materialization_history esquema:

  1. En la consola de la cuenta, haga clic en Vista previa en el panel izquierdo.
  2. Habilitar la Tabla del sistema de historial de materialización para compartir.

Esquema de tabla de sistema de historial de datos materializados compartidos

La tabla del sistema de historial de datos materializados compartidos utiliza el siguiente esquema:

Nombre de la columna Tipo Descripción Ejemplo de datos Anulable
sharing_materialization_id cuerda / cadena El identificador único de una materialización de datos. da38803f-2a62-4e27-bdb9-29b801c6dd84 Falso
account_id cuerda / cadena ID de la cuenta de Azure Databricks donde se creó la materialización. Falso
workspace_id cuerda / cadena El ID del espacio de trabajo de Azure Databricks facturado. 6051921418418893 Falso
recipient_name cuerda / cadena Nombre del destinatario mediante la materialización de datos. e2-dogfood Cierto
provider_name cuerda / cadena Nombre del proveedor que utiliza la materialización de datos. aws:us-west-2:19a85dee-54bc-43a2-87ab-023d0ec16013 Cierto
share_name cuerda / cadena Nombre del recurso compartido utilizado para crear la materialización de datos. my_share Falso
schema_name cuerda / cadena Nombre del esquema del recurso compartido. my_schema Falso
table_name cuerda / cadena Nombre de la tabla utilizada para crear la materialización de datos. stocks Falso
created_at marca de tiempo Marca de hora de creación de la materialización. 2025-01-01 00:00:00 Falso

Consultas de ejemplo

En esta sección se incluyen las siguientes consultas de ejemplo que puede usar para obtener información sobre la atribución de facturación:

Cuando se cobra al proveedor por la materialización de datos, solo el proveedor puede ver los resultados de la consulta. Cuando al destinatario se le cobra por la materialización de datos, solo el destinatario puede visualizar los resultados de la consulta.

Para obtener más detalles sobre cómo los atributos de Delta Sharing generan costos, consulte ¿Cómo incurro y verifico los costos de uso compartido de Delta?.

Un destinatario de Delta Sharing pregunta cuántos DBU se han utilizado para consultar vistas compartidas.

Sustituya las instancias de ... con su información.

SELECT
  SUM(bu.usage_quantity)
FROM
  system.billing.usage bu
INNER JOIN
  system.sharing.materialization_history dm
ON
  dm.sharing_materialization_id = bu.usage_metadata.sharing_materialization_id
WHERE
  bu.billing_origin_product = 'DATA_SHARING' AND
 dm.share_name = '...' AND
 dm.schema_name = '...' AND
 dm.table_name IN (...);

Un destinatario de Delta Sharing pregunta qué proveedor consultó el mayor uso

SELECT
  SUM(bu.usage_quantity) AS total_usage,
  dm.provider_name
FROM
  system.billing.usage bu
INNER JOIN
  system.sharing.materialization_history dm
ON
  dm.sharing_materialization_id = bu.usage_metadata.sharing_materialization_id
WHERE
  bu.billing_origin_product = 'DATA_SHARING'
GROUP BY
  dm.provider_name
ORDER BY
  total_usage DESC;

Un proveedor de Delta Sharing pregunta cuántos DBUs se han gastado en filtrar vistas para los destinatarios abiertos.

SELECT
  SUM(bu.usage_quantity)
FROM
  system.billing.usage bu
INNER JOIN
  system.sharing.materialization_history dm
ON
  dm.sharing_materialization_id = bu.usage_metadata.sharing_materialization_id
INNER JOIN
  system.information_schema.table_share_usage tsu
ON
  dm.share_name = tsu.share_name AND
  dm.schema_name = tsu.schema_name AND
  dm.table_name = tsu.table_name
INNER JOIN
  system.information_schema.tables t
ON
  t.table_catalog = tsu.catalog_name AND
  t.table_schema = tsu.schema_name AND
  t.table_name = tsu.table_name
WHERE
  bu.billing_origin_product = 'DATA_SHARING' AND
  t.table_type = 'VIEW';

Un proveedor de delta sharing pregunta qué destinatario abierto incurre en el mayor costo

SELECT
 SUM(usage_quantity) AS usage,
 srp.recipient_name
FROM
  system.billing.usage bu
INNER JOIN
  system.sharing.materialization_history dm
ON
  dm.sharing_materialization_id = bu.usage_metadata.sharing_materialization_id
INNER JOIN system.information_schema.share_recipient_privileges srp
ON
  srp.share_name = dm.share_name
WHERE
  bu.billing_origin_product = 'DATA_SHARING'
GROUP BY
  srp.recipient_name
ORDER BY
  usage DESC
LIMIT 1;
  • Last updated on