Marcar recursos do Athena com tags - Amazon Athena
Conceitos Básicos de TagsRestrições de tags

Marcar recursos do Athena com tags

Uma tag consiste em uma chave e um valor, ambos definidos por você. Ao marcar um recurso do Athena, você atribui metadados personalizados a ele. Você pode usar etiquetas para categorizar seus recursos da AWS de diferentes formas, como por finalidade, proprietário ou ambiente. No Athena, recursos como grupos de trabalho, catálogos de dados e reservas de capacidade são recursos etiquetáveis. Por exemplo, você pode criar um conjunto de tags para grupos de trabalho na sua conta que ajuda a rastrear os proprietários do grupo de trabalho ou identificar grupos de trabalho por finalidade. Se você também habilitar as tags como tags de alocação de custos no console do Billing and Cost Management, os custos associados à execução de consultas aparecerão em seu Relatório de custos e uso com essa tag de alocação de custos. Recomendamos usar as práticas recomendadas de marcação com tags da AWS para criar um conjunto consistente de tags que atenda às necessidades da sua organização.

Você pode trabalhar com etiquetas usando o console do Athena ou as operações de API.

Tópicos

Conceitos Básicos de Tags

Uma etiqueta é um rótulo atribuído a um recurso do Athena. Cada tag consiste em uma chave e um valor opcional, ambos definidos por você.

As etiquetas permitem categorizar seus recursos da AWS de maneiras diferentes. Por exemplo, você pode definir um conjunto de tags para os grupos de trabalho da sua conta que ajudem a rastrear o proprietário ou a finalidade de cada grupo de trabalho.

É possível adicionar etiquetas ao criar um grupo de trabalho ou catálogo de dados do Athena ou adicionar, editar ou remover etiquetas dele. Você pode editar uma tag no console. Se você usar as operações da API para editar uma tag, remova a tag antiga e adicione uma nova. Caso exclua um recurso, todas as respectivas tags também serão excluídas.

O Athena não atribui etiquetas automaticamente aos recursos. É possível editar chaves de tags e valores, e é possível remover as tags de um recurso a qualquer momento. É possível definir o valor de uma tag a uma string vazia, mas não pode configurar o valor de um tag como nula. Não adicione chaves de tag duplicadas ao mesmo recurso. Se você fizer isso, o Athena emitirá uma mensagem de erro. Se você usar a ação TagResource para marcar um recurso usando uma chave de tag existente, o novo valor da tag substituirá o valor antigo.

No IAM, é possível controlar quais usuários na sua conta da Amazon Web Services têm permissão para criar, editar, remover ou listar etiquetas. Para ter mais informações, consulte Usar políticas de controle de acesso do IAM baseadas em tags.

Para obter uma lista completa de ações de etiqueta do Amazon Athena, consulte os nomes das ações de API na Referência de API do Amazon Athena.

Você pode usar tags para faturamento. Para obter mais informações, consulte Usar etiquetas para faturamento no Guia do usuário do AWS Billing and Cost Management.

Para ter mais informações, consulte Restrições de tags.

Restrições de tags

As tags têm as seguintes restrições:

  • No Athena, você pode marcar grupos de trabalho e catálogos de dados. Você não pode marcar consultas com tags.

  • O número máximo de tags por recurso é 50. Para permanecer no limite, revise e exclua tags não utilizadas.

  • Em todos os recursos, cada chave de tag deve ser exclusiva e possuir apenas um valor. Não adicione chaves de tag duplicadas ao mesmo tempo ao mesmo recurso. Se você fizer isso, o Athena emitirá uma mensagem de erro. Se você marcar um grupo de trabalho usando uma chave de tag existente em uma ação TagResource separada, o novo valor da tag substituirá o valor antigo.

  • O comprimento da chave da tag é de 1-128 caracteres Unicode em UTF-8.

  • O comprimento do valor da tag é de 0-256 caracteres Unicode em UTF-8.

    Marcar operações, como adicionar, editar, remover ou listar tags, exigem que você especifique um ARN para o recurso do grupo de trabalho.

  • O Athena permite usar letras, números, espaços representados em UTF-8 e os seguintes caracteres: + - = . _ : / @.

  • As chaves e os valores de tags diferenciam maiúsculas de minúsculas.

  • O prefixo "aws:" nas chaves de tag é reservado para uso da AWS. Você não pode editar nem excluir chaves de tag com esse prefixo. As tags com esse prefixo não contam contra o limite de tags por recurso.

  • As etiquetas atribuídas estão disponíveis somente para a sua conta da Amazon Web Services.