

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
<a name="understanding-report-versions"></a>

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 suporte a integração de seus dados com o Amazon Athena, o Amazon Redshift ou o Quick.

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
<a name="access-cur-s3-timeline"></a>

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
<a name="keeping-previous-cur"></a>

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](#manifest-cur-files)

## Substituir relatórios de custos e uso anteriores
<a name="overwrite-previous-cur"></a>

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
<a name="overwrite-athena"></a>

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
<a name="overwrite-cloudformation"></a>

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](cur-query-athena.md).

## Arquivos de manifesto dos relatórios de custos e uso
<a name="manifest-cur-files"></a>

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

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
<a name="manifest-cur-keeping"></a>

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`. Sempre 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
<a name="manifest-cur-overwrite"></a>

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
<a name="manifest-cur-RS"></a>

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
<a name="manifest-cur-Athena"></a>

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>
```