Introdução a rótulos

Para ajudar a organizar seus recursos do BigQuery, adicione rótulos aos seus conjuntos de dados, tabelas e visualizações. Rótulos são pares de chave-valor que você anexa a um recurso. Quando você cria recursos do BigQuery, os rótulos são opcionais.

Depois de rotular seus recursos, procure-os com base nos valores do rótulo. Por exemplo, use rótulos para agrupar conjuntos de dados por finalidade, ambiente, departamento e assim por diante.

O que são rótulos?

Um rótulo é um par de chave-valor que ajuda você a organizar seus recursos do BigQuery no Google Cloud Platform. É possível anexar um rótulo a cada recurso e filtrar os recursos com base nesses rótulos. As informações sobre os rótulos são encaminhadas ao sistema de faturamento para que você possa classificar as cobranças de faturamento por rótulo.

Usos comuns dos rótulos

Não recomendamos a criação de um grande número de rótulos exclusivos, como carimbos de data/hora ou valores individuais para todas as chamadas de API. Veja alguns casos de uso comum de rótulos:

  • Rótulos de equipe ou centro de custo: para distinguir os recursos do BigQuery pertencentes a diferentes equipes, adicione rótulos com base na equipe ou no centro de custo. Por exemplo, team:research e team:analytics. Esse tipo de rótulo pode ser usado para contabilidade de custos ou elaboração de orçamentos.

  • Rótulos de componentes: por exemplo, component:redis, component:frontend, component:ingest e component:dashboard.

  • Rótulos de ambiente ou estágio: por exemplo, environment:production e environment:test.

  • Rótulos de estado: por exemplo, state:active, state:readytodelete e state:archive.

Requisitos para rótulos

Os rótulos aplicados a um recurso precisam atender aos seguintes requisitos:

  • Cada recurso pode ter vários rótulos, até um máximo de 64.
  • Cada rótulo precisa ser um par de chave-valor.
  • As chaves têm comprimento mínimo de 1 e máximo de 63 caracteres. Além disso, elas não podem estar vazias. Os valores podem estar vazios e ter um comprimento máximo de 63 caracteres.
  • As chaves e os valores contêm apenas letras minúsculas, caracteres numéricos, sublinhados e traços. Todos os caracteres precisam usar a codificação UTF-8, e os caracteres internacionais são permitidos.
  • A parte da chave de um rótulo precisa ser única. No entanto, use a mesma chave com vários recursos.
  • As chaves precisam começar com uma letra minúscula ou um caractere internacional.

A seguir

Esta página foi útil? Conte sua opinião sobre:

Enviar comentários sobre…

Precisa de ajuda? Acesse nossa página de suporte.