

# Exemplos de uso do Amazon S3 Select em um objeto
<a name="using-select"></a>

**Importante**  
O Amazon S3 Select não está mais disponível para novos clientes. Os clientes existentes do Amazon S3 Select podem continuar usando o recurso normalmente. [Saiba mais](https://aws.amazon.com/blogs/storage/how-to-optimize-querying-your-data-in-amazon-s3/) 

É possível usar o S3 Select para selecionar conteúdo de um objeto usando o console do Amazon S3, a API REST e SDKs da AWS. 

Para receber mais informações sobre as funções SQL compatíveis com o S3 Select, consulte [Funções SQL](s3-select-sql-reference-sql-functions.md).

## Usar o console do S3
<a name="s3-select-objects-console"></a>

**Como selecionar o conteúdo de um objeto no console do Amazon S3**

1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon S3 em [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).

1. No painel de navegação à esquerda, escolha **Buckets**.

1. Escolha o bucket que contém o objeto do qual você deseja selecionar o conteúdo; depois, escolha o nome do objeto.

1. Escolha **Ações de objeto** e **Consultar com o S3 Select**.

1. Defina as **Configurações de entrada**, com base no formato dos dados de entrada.

1. Defina as **Configurações de saída**, com base no formato da saída que você deseja receber.

1. Para extrair registros do objeto escolhido, em **Consulta SQL**, insira os comandos SQL SELECT. Para obter mais informações sobre como escrever comandos SQL, consulte [Referência SQL para o Amazon S3 Select](s3-select-sql-reference.md).

1. Depois de inserir consultas SQL, escolha **Executar consulta SQL**. Depois, em **Resultados da consulta**, é possível ver os resultados das consultas SQL.

## Uso da API REST
<a name="SelectObjectContentUsingRestApi"></a>

É possível usar SDKs da AWS para selecionar conteúdo de um objeto. Contudo, se o seu aplicativo exigir, você pode enviar solicitações REST diretamente. Para obter mais informações sobre o formato de solicitação e de resposta, consulte [https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectSELECTContent.html](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectSELECTContent.html).

## Usar SDKs da AWS
<a name="SelectObjectContentUsingSDK"></a>

É possível usar o Amazon S3 Select para selecionar parte do conteúdo de um objeto usando o método `selectObjectContent`. Se esse método for bem-sucedido, ele retornará os resultados da expressão SQL.

------
#### [ Java ]

Para usar o Amazon S3 Select com o AWS SDK para Java, você pode exibir o valor da primeira coluna para cada registro armazenado em um objeto que contenha dados armazenados no formato CSV. Você também pode solicitar que mensagens de `Progress` e `Stats` sejam exibidas. É necessário fornecer um nome de bucket válido e um objeto que contenha dados em formato CSV.

Para usar o Amazon S3 Select com o AWS SDK para Java, você pode exibir o valor da primeira coluna para cada registro armazenado em um objeto que contenha dados armazenados no formato CSV. Você também pode solicitar que mensagens de `Progress` e `Stats` sejam exibidas. É necessário fornecer um nome de bucket válido e um objeto que contenha dados em formato CSV.

Para ver exemplos de como usar o Amazon S3 Select com o AWS SDK para Java, consulte [Select content from an object](https://docs.aws.amazon.com/AmazonS3/latest/API/s3_example_s3_SelectObjectContent_section.html) na *Referência de API do Amazon S3*.

------
#### [ JavaScript ]

Para obter um exemplo de JavaScript que usa o AWS SDK para JavaScript com a operação de API `SelectObjectContent` do S3 para selecionar registros dos arquivos JSON e CSV armazenados no Amazon S3, consulte a publicação de blog [Adição de suporte ao Amazon S3 Select no AWS SDK para JavaScript](https://aws.amazon.com/blogs/developer/introducing-support-for-amazon-s3-select-in-the-aws-sdk-for-javascript/). 

------
#### [ Python ]

Para obter um exemplo do Python sobre o uso de consultas SQL para pesquisar dados carregados no Amazon S3 como um arquivo de valor separado por vírgulas (CSV) usando o S3 Select, consulte a publicação do blog [Consultar dados sem servidores ou bancos de dados usando o Amazon S3 Select](https://aws.amazon.com/blogs/storage/querying-data-without-servers-or-databases-using-amazon-s3-select/). 

------