Noções básicas sobre as versões dos relatórios - Exportações de dados da AWS
Cronograma de entrega do AWS CURCriar versões de relatório de custos e usoSubstituir relatórios de custos e uso anterioresArquivos de manifesto dos relatórios de custos e uso

Noções básicas sobre as versões dos relatórios

A AWS atualiza o Relatório de Custos e Uso pelo menos uma vez por dia até que suas cobranças sejam finalizadas. Ao criar um relatório, você pode optar por criar novas versões do relatório ou substituir a versão existente do relatório a cada atualização.

Seus arquivos de relatório incluem um arquivo.csv ou uma coleção de arquivos.csv e o arquivo de manifesto. Seu relatório também pode incluir qualquer arquivo adicional que comporte a integração de seus dados ao Amazon Athena, ao Amazon Redshift ou ao Quick Suite.

As seções a seguir descrevem a organização do arquivo e as convenções de nomenclatura com base no versionamento de relatórios que você escolher.

Cronograma de entrega dos relatórios de custos e uso

Durante o período do relatório, a AWS entrega um novo relatório e um novo arquivo manifesto sempre que a AWS atualiza o relatório. A AWS baseia-se em relatórios anteriores até o final do período de faturamento. Após o término do período de faturamento do relatório, a AWS gera um novo relatório que não contém nenhuma informação do relatório anterior.

Criar versões de relatório de custos e uso

Ao optar por manter os relatórios de custos e uso anteriores, o AWS CUR usa a organização e convenções de nomenclatura do Amazon S3 a seguir.

<example-report-prefix>/<example-report-name>/yyyymmdd-yyyymmdd/<assemblyId>/<example-report-name>-<file-number>.csv.<zip|gz>

  • report-prefix = o prefixo que você atribui ao relatório.

  • report-name = o nome que você atribui ao relatório.

  • yyyymmdd-yyyymmdd = O intervalo de datas coberto pelo relatório. Os relatórios são finalizadas no fim do intervalo de datas.

  • assemblyId = uma ID criada pela AWS sempre que o relatório é atualizado.

  • file-number = se a atualização incluir um arquivo grande, a AWS pode dividi-lo em vários arquivos. O file-number controla os diferentes arquivos de uma atualização.

  • csv = formato dos arquivos de relatório.

  • zip ou gz = tipo de compactação aplicada nos arquivos de relatório.

Por exemplo, seu relatório pode ser entregue como um conjunto dos seguintes arquivos.

<example-report-prefix>/<example-report-name>/20160101-20160131/<123456789>/<example-report-name>-<1>.csv.<zip>
<example-report-prefix>/<example-report-name>/20160101-20160131/<123456789>/<example-report-name>-<2>.csv.<zip>
<example-report-prefix>/<example-report-name>/20160101-20160131/<123456789>/<example-report-name>-<3>.csv.<zip>
<example-report-prefix>/<example-report-name>/20160101-20160131/<123456789>/<example-report-name>-Manifest.json
<example-report-prefix>/<example-report-name>/20160101-20160131/<example-report-name>-Manifest.json

AWS fornece todos os relatórios de um intervalo de datas na mesma pasta report-prefix/report-name/yyyymmdd-yyyymmdd. AWS fornece a cada relatório um ID exclusivo e o entrega na subpasta assemblyId, na pasta do intervalo de datas. Se for muito grande para um único arquivo, o relatório será dividido em vários arquivos e entregue na mesma pasta assemblyId.

Para obter mais informações sobre como manifestar arquivos ao manter um relatório anterior, consulte Arquivos de manifesto dos relatórios de custos e uso

Substituir relatórios de custos e uso anteriores

Ao optar por substituir os relatórios de custos e uso anteriores, o AWS CUR usa a organização e as convenções de nomenclatura do Amazon S3 a seguir.

<example-report-prefix>/<example-report-name>/yyyymmdd-yyyymmdd/<example-report-name>-<file-number>.csv.<zip|gz>

  • report-prefix = o prefixo que você atribui ao relatório.

  • report-name = o nome que você atribui ao relatório.

  • yyyymmdd-yyyymmdd = o intervalo de datas que o relatório abrange. A AWS finaliza relatórios no final do intervalo de datas.

  • file-number = se a atualização incluir um arquivo grande, a AWS pode dividi-lo em vários arquivos. O file-number controla os diferentes arquivos de uma atualização.

  • csv = formato dos arquivos de relatório.

  • zip ou gz = tipo de compactação aplicada nos arquivos de relatório.

Por exemplo, seu relatório pode ser entregue como um conjunto dos seguintes arquivos.

<example-report-prefix>/<example-report-name>/yyyymmdd-yyyymmdd/<example-report-name>-<1>.csv.<zip>
<example-report-prefix>/<example-report-name>/yyyymmdd-yyyymmdd/<example-report-name>-<2>.csv.<zip><example-report-prefix>/<example-report-name>/yyyymmdd-yyyymmdd/<example-report-name>-<3>.csv.<zip>
<example-report-prefix>/<example-report-name>/yyyymmdd-yyyymmdd/<example-report-name>-Manifest.json

Especificações do Athena

Se você escolher o suporte do Athena ao criar o AWS CUR, as convenções de nomenclatura de arquivo serão as mesmas de quando você optar por substituir o AWS CUR, com exceção do formato e da compactação. Em vez disso, os arquivos AWS CUR do Athena usam .parquet. Por exemplo, seu relatório pode ser entregue como um conjunto dos seguintes arquivos.

<example-report-prefix>/<example-report-name>/yyyymmdd-yyyymmdd/<example-report-name>.parquet
<example-report-prefix>/<example-report-name>/yyyymmdd-yyyymmdd/<cost_and_usage_data_status>
<example-report-prefix>/<example-report-name>/yyyymmdd-yyyymmdd/<example-report-name>-Manifest.json
<example-report-prefix>/<example-report-name>/yyyymmdd-yyyymmdd/<example-report-name>-create-table.sql
<example-report-prefix>/<example-report-name>/yyyymmdd-yyyymmdd/crawler-cfn.yml

CloudFormationEspecificações do

Além dos arquivos do AWS CUR, a AWS também fornece um modelo do CloudFormation que pode ser usado para configurar uma pilha do CloudFormation que permite consultar dados do Amazon S3 usando o Athena. Se você não deseja usar o modelo do CloudFormation, você pode usar o SQL fornecido para criar suas próprias tabelas do Athena. Para obter mais informações, consulte Consultar relatórios de custos e uso com o Amazon Athena.

Arquivos de manifesto dos relatórios de custos e uso

Quando a AWS atualiza o AWS CUR, a AWS também cria e entrega arquivos de manifesto que você pode usar para Amazon Athena, Amazon Redshift ou Quick Suite.

Os arquivos manifesto usam as convenções de nomenclatura e listam o seguinte:

  • Todas as colunas de detalhes incluídas no relatório até o momento

  • Uma lista dos arquivos do relatório, se o relatório foi dividido em vários arquivos

  • O período abrangido pelo relatório e outras informações.

<example-report-prefix>/<example-report-name>/yyyymmdd-yyyymmdd/<example-report-name>-Manifest.json
<example-report-prefix>/<example-report-name>/yyyymmdd-yyyymmdd/<assemblyId>/<example-report-name>-Manifest.json
<example-report-prefix>/<example-report-name>/<example-report-name>/year=2018/month=12/<example-report-name>-Manifest.json

Criar versões de relatório de custos e uso

Quando você mantém os relatórios de custos e uso anteriores, o arquivo de manifesto é entregue na pasta do intervalo de datas e na pasta assemblyId. Toda vez que a AWS cria um AWS CUR para um intervalo de datas, o arquivo de manifesto armazenado na pasta do intervalo de datas é substituído por um arquivo de manifesto atualizado. A AWS fornece o mesmo arquivo de manifesto atualizado na pasta assemblyId com os arquivos dessa atualização. Os arquivos manifesto na pasta assemblyId não são substituídos.

Substituir relatórios de custos e uso anteriores

Quando você substitui o AWS CUR anterior, o arquivo de manifesto é entregue na pasta month=mm. O arquivo manifesto é substituído junto com os arquivos de relatório.

Especificações do Amazon Redshift

Se você optar por oferecer suporte ao Amazon Redshift no AWS CUR, a AWS também criará e fornecerá um arquivo com os comandos SQL necessários para fazer upload de seu relatório no Amazon Redshift. É possível abrir o arquivo SQL com um editor de texto normal. O arquivo SQL usa a seguinte convenção de nomenclatura.


<example-report-prefix>/<example-report-name>/yyyymmdd-yyyymmdd/<assemblyId>/<example-report-name>-RedshiftCommands.sql

Se você usar os comandos do arquivo RedshiftCommands, não será necessário abrir o arquivo RedshiftManifest.

Importante

O arquivo manifest determina quais arquivos de relatório o comando copy no arquivo RedshiftCommands carrega. A exclusão ou a remoção do arquivo manifest quebra o comando de cópia do arquivo RedshiftCommands.

Especificações do Amazon Athena

Se você escolher a opção de suporte do Amazon Athena no AWS CUR, a AWS também criará e fornecerá vários arquivos para ajudar a configurar todos os recursos necessários. A AWS fornece um modelo do CloudFormation, um arquivo SQL com o SQL para criar a tabela do Athena manualmente e um arquivo com o SQL para verificar o status de atualização do AWS CUR. Esses arquivos usam as seguintes convenções de nomenclatura.

<example-report-prefix>/<example-report-name>/<example-report-name>/yyyymmdd-yyyymmdd/crawler-cfn.yml
<example-report-prefix>/<example-report-name>/<example-report-name>/yyyymmdd-yyyymmdd/<example-report-name>-create-table.sql
<example-report-prefix>/<example-report-name>/<example-report-name>/yyyymmdd-yyyymmdd/<cost_and_usage_data_status>