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 consultas de exemplo. Com as tabelas do sistema, os dados de utilização faturáveis da sua conta são centralizados e encaminhados para todas as regiões, para que possa ver a utilização global da sua conta a partir de qualquer região em que o seu espaço de trabalho se encontre.

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

Caminho da tabela: Esta tabela do sistema encontra-se 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 de metadados de uso

Os valores em usage_metadata são todas as cadeias de caracteres que informam sobre os objetos e recursos do espaço de trabalho envolvidos no registro de uso.

Apenas um subconjunto desses valores é preenchido em qualquer registro de uso, dependendo do tipo de computação e dos recursos usados. A terceira coluna da tabela mostra quais tipos de uso fazem com que cada valor seja preenchido.

Referência de metadados de identidade

A coluna identity_metadata fornece mais informações sobre as identidades envolvidas no uso.

• O campo run_as regista quem executou a carga de trabalho. Esses valores só são preenchidos para determinados tipos de carga de trabalho listados na tabela abaixo.
• 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.

• O created_by campo aplica-se às Apps da Databricks e aos Agent Bricks, e regista o email do utilizador que criou a aplicação ou o agente.

executar_como identidades

A identidade registada em identity_metadata.run_as depende do produto associado à utilização. Consulte a tabela a seguir para o comportamento identity_metadata.run_as:

Referência do tipo de registo

A tabela billing.usage suporta 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 registos à tabela. Um registro de retração nega o registro incorreto original e, em seguida, um registro de reafirmação inclui as informações corrigidas. Os registos de correção são identificados através do record_type campo:

• RETRACTION: Usado para negar o uso incorreto original. Todos os campos são idênticos ao ORIGINAL registro, 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 retraçã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 horário correta relacionada a um job_id, mesmo que correções tenham sido feitas. Ao agregar a quantidade de uso, o registo de retração anula o registo original e apenas os valores da redeclaraçã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 na origem da faturação

Alguns produtos Databricks são cobrados sob a mesma SKU compartilhada. Por exemplo, o monitoramento da qualidade dos dados, a otimização preditiva e os fluxos de trabalho sem servidor são cobrados sob a mesma SKU de trabalhos sem servidor.

Para ajudá-lo a diferenciar o uso, as colunas billing_origin_product e product_features fornecem mais informações sobre o produto específico e os recursos associados ao uso.

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

Referência de características 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: