Noções básicas sobre as versões dos relatórios - Exportações de dados da AWS

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

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

AWS atualiza seu Relatório de Custo 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,AWS entrega um novo relatório e um novo arquivo de manifesto sempre que AWS atualiza o relatório.AWS baseia-se em relatórios anteriores até o final do período de cobrança. Após o final do período de cobrança do relatório,AWS gera um novo relatório sem nenhuma das informações do relatório anterior.

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

Quando você opta por manter seus relatórios de custo e uso anteriores, seu AWS CUR usa as seguintes convenções de organização e nomenclatura do Amazon S3.

<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= Um ID que éAWS criado sempre que o relatório é atualizado.

  • file-number= Se a atualização incluir um arquivo grande,AWS poderá 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 entrega todos os relatórios em um intervalo de datas do relatório na mesma report-prefix/report-name/yyyymmdd-yyyymmdd pasta.AWS dá a cada relatório uma ID exclusiva e o entrega na assemblyId subpasta 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

Quando você opta por sobrescrever seus relatórios de custo e uso anteriores, seu AWS CUR usa as seguintes convenções de organização e nomenclatura do Amazon S3.

<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,AWS poderá 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ê escolheu o suporte ao Athena ao criar seu AWS CUR, as convenções de nomenclatura de arquivo são as mesmas de quando você escolhe sobrescrever seu AWS CUR, exceto pelo formato e pela compactação. Em vez disso, os arquivos AWS CUR do Athena são usados. .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

CloudFormation especificações

Além dos arquivos AWS CUR,AWS também fornece um CloudFormation modelo que você pode usar para configurar uma CloudFormation pilha que permite consultar dados do Amazon S3 usando o Athena. Se você não quiser usar o CloudFormation modelo, poderá 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 AWS atualiza o AWS CUR,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. Cada vez que AWS cria um novo AWS CUR para um intervalo de datas, ele substitui o arquivo de manifesto armazenado na pasta do intervalo de datas por um arquivo de manifesto atualizado.AWS entrega o mesmo arquivo de manifesto atualizado para a assemblyId pasta junto 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ê sobrescreve o AWS CUR anterior, o arquivo de manifesto é entregue à month=mm pasta. O arquivo manifesto é substituído junto com os arquivos de relatório.

Especificações do Amazon Redshift

Se você escolheu a opção de suporte ao Amazon Redshift em seu AWS CUR,AWS também cria e entrega um arquivo com os comandos SQL necessários para carregar 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ê escolheu a opção de suporte ao Amazon Athena em seu AWS CUR,AWS também cria e entrega vários arquivos para ajudar a configurar todos os recursos necessários.AWS fornece um CloudFormation modelo, um arquivo SQL com o SQL para criar sua tabela 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>