Referência da tabela do sistema de uso faturável

Este artigo fornece uma visão geral da tabela do sistema de uso faturável, incluindo o esquema e as consultas de exemplo. Com as tabelas do sistema, os dados de uso faturáveis da sua conta são centralizados e roteados para todas as regiões, para que você possa exibir o uso global da sua conta de qualquer região em que seu espaço de trabalho se encontre.

Para obter informações sobre como usar essa tabela para monitorar custos e consultas de exemplo, consulte Monitorar custos usando tabelas do sistema.

Caminho da tabela: esta tabela do sistema está localizada em system.billing.usage.

Esquema da tabela de uso faturável

A tabela do sistema de uso faturável usa o seguinte esquema:

Referência dos metadados de uso

Os valores em usage_metadata informam sobre os objetos e recursos envolvidos no registro de uso.

Referência dos metadados de identidade

A coluna identity_metadata fornece mais informações sobre as identidades envolvidas no uso. O campo run_as registra quem executou a carga de trabalho. O campo owned_by só se aplica ao uso do SQL Warehouse e registra o usuário ou a entidade de serviço que possui o SQL Warehouse responsável pelo uso.

Além disso, o uso atribuído aos Aplicativos do Databricks registra um valor no campo identity_metadata.created_by. Esse valor é preenchido com o email do usuário que criou o aplicativo.

identidades run_as

A identidade registrada em identity_metadata.run_as depende do produto associado ao uso. Consulte a tabela a seguir para obter o comportamento identity_metadata.run_as:

Referência do tipo de registro

A tabela billing.usage oferece suporte às correções. As correções ocorrem quando qualquer campo do registro de uso está incorreto e deve ser corrigido.

Quando ocorre uma correção, o Azure Databricks adiciona dois novos registros à tabela. Um registro de retratação nega o registro incorreto original e, em seguida, um registro de reformulação inclui as informações corrigidas. Os registros de correção são identificados usando o campo record_type:

• RETRACTION: usado para negar o uso incorreto original. Todos os campos são idênticos ao registro de ORIGINAL, exceto usage_quantity, que é um valor negativo que cancela a quantidade de uso original. Por exemplo, se a quantidade de uso do registro original fosse 259.4356, o registro de retratação teria uma quantidade de uso de -259.4356.
• RESTATEMENT: o registro que inclui os campos corretos e a quantidade de uso.

Por exemplo, a consulta a seguir retorna a quantidade de uso por hora correta relacionada a um job_id, mesmo que as correções tenham sido feitas. Ao agregar a quantidade de uso, o registro de retratação nega o registro original e apenas os valores de declaração são retornados.

SELECT
  usage_metadata.job_id, usage_start_time, usage_end_time,
  SUM(usage_quantity) as usage_quantity
FROM system.billing.usage
GROUP BY ALL
HAVING usage_quantity != 0

Referência do produto de origem de cobrança

Alguns produtos do Databricks são cobrados na mesma SKU compartilhada. Para ajudá-lo a diferenciar o uso, as colunas billing_origin_product e product_features fornecem mais informações sobre o produto e os recursos específicos associados ao uso.

A coluna billing_origin_product mostra o produto do Databricks associado ao registro de uso. Os valores incluem:

• JOBS
• DLT
• SQL
• ALL_PURPOSE
• MODEL_SERVING
• INTERACTIVE
• DEFAULT_STORAGE
• VECTOR_SEARCH
• LAKEHOUSE_MONITORING
• PREDICTIVE_OPTIMIZATION
• ONLINE_TABLES
• FOUNDATION_MODEL_TRAINING
• AGENT_EVALUATION
• FINE_GRAIN_ACCESS_CONTROL

• NETWORKING: custos associados à conexão da computação sem servidor aos seus recursos pelos pontos de extremidade privados. Para uso NETWORKING, workspace_id é null, usage_unit é houre networking.connectivity_type é PRIVATE_IP.
• APPS: custos associados à criação e execução de aplicativos Databricks

Referência de funcionalidades do produto

A coluna product_features é um objeto que contém informações sobre os recursos específicos do produto usados e inclui os seguintes pares chave/valor:

• jobs_tier: os valores incluem LIGHT, CLASSIC ou null
• sql_tier: os valores incluem CLASSIC, PRO ou null
• dlt_tier: os valores incluem CORE, PRO, ADVANCED ou null
• is_serverless: os valores incluem true ou false, ou null
• is_photon: os valores incluem true ou false, ou null
• serving_type: os valores incluem MODEL, GPU_MODEL, FOUNDATION_MODEL, FEATURE ou null

• networking.connectivity_type: os valores incluem PUBLIC_IP e PRIVATE_IP