

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á.

# Configurando e consultando uma fonte de dados do S3 em painéis OpenSearch
<a name="direct-query-s3-configure"></a>

Depois de criou a fonte de dados, é possível definir configurações de segurança, suas tabelas do Amazon S3 ou a indexação acelerada de dados. Esta seção mostra vários casos de uso com sua fonte de dados em OpenSearch painéis antes de você consultar seus dados.

Para configurar as seções a seguir, primeiro você deve navegar até sua fonte de dados em OpenSearch Painéis. Na navegação à esquerda, em **Gerenciamento**, selecione **Fontes de dados**. Em **Gerenciar fontes de dados**, selecione o nome da fonte de dados criada no console. 

## Crie tabelas do Spark usando o Query Workbench
<a name="direct-query-s3-configure-tables"></a>

As consultas diretas do OpenSearch Service para o Amazon S3 usam tabelas Spark dentro do. AWS Glue Data Catalog Você pode criar tabelas de dentro do Query Workbench sem precisar sair dos OpenSearch painéis. 

Para gerenciar bancos de dados e tabelas existentes na sua fonte de dados ou para criar novas tabelas para usar em consultas diretas, escolha **Query Workbench** no painel de navegação à esquerda e selecione a fonte de dados do Amazon S3 na lista suspensa de fontes de dados.

Para configurar uma tabela para logs de fluxo da VPC armazenados no S3 no formato Parquet, execute a seguinte consulta: 

```
CREATE TABLE 
datasourcename.gluedatabasename.vpclogstable (version INT, account_id STRING, interface_id STRING, 
srcaddr STRING, dstaddr STRING, srcport INT, dstport INT, protocol INT, packets BIGINT, 
bytes BIGINT, start BIGINT, end BIGINT, action STRING, log_status STRING, 
`aws-account-id` STRING, `aws-service` STRING, `aws-region` STRING, year STRING, 
month STRING, day STRING, hour STRING) 

USING parquet PARTITIONED BY (aws-account-id, aws-service, aws-region, year, month, 
day, hour) 

LOCATION "s3://accountnum-vpcflow/AWSLogs"
```

Depois de criar a tabela, execute a consulta a seguir para garantir que ela seja compatível com consultas diretas:

```
MSCK REPAIR TABLE  datasourcename.databasename.vpclogstable
```

## Configurar integrações para tipos de AWS log populares
<a name="direct-query-s3-setup-integration"></a>

Você pode integrar os tipos de AWS log armazenados no Amazon S3 com OpenSearch o Service. Use OpenSearch painéis para instalar integrações que criam AWS Glue Data Catalog tabelas, consultas salvas e painéis. Essas integrações usam visões indexadas para manter os painéis atualizados.

Para obter instruções sobre como instalar uma integração, consulte [Instalação de um ativo de integração](https://opensearch.org/docs/latest/integrations/#installing-an-integration-asset) na OpenSearch documentação.

Ao selecionar uma integração, certifique-se de que ela tenha a tag `S3 Glue`. 

Ao configurar a integração, especifique **Conexão do S3** como o tipo de conexão. Depois, selecione a fonte de dados para a integração, a localização dos dados no Amazon S3, o ponto de verificação para gerenciar a indexação de aceleração e os ativos necessários para o seu caso de uso.

**nota**  
Certifique-se de que o bucket S3 para seu ponto de verificação tenha permissões de gravação no local para o ponto de verificação. Sem essas permissões, acelerações da integração não terão sucesso.

## Configurar o controle de acesso
<a name="direct-query-s3-configure-ac"></a>

Na página de detalhes da fonte de dados, encontre a seção **Controles de acesso** e escolha **Editar**. Se o domínio tiver controle de acesso refinado habilitado, escolha **Restrito** e selecione os perfis aos quais pretende conceder acesso à nova fonte de dados. Também é possível escolher **Somente administrador** para que somente o administrador tenha acesso à fonte de dados.

**Importante**  
Índices são usados para qualquer consulta na fonte de dados. Um usuário com acesso para leitura ao índice de solicitações de uma determinada fonte de dados pode ler *todas* as consultas nessa fonte. Um usuário com acesso para leitura ao índice de resultados pode ler os resultados de *todas* as consultas nessa fonte de dados.

## Consultando dados do S3 no Discover OpenSearch
<a name="direct-querying-s3-query"></a>

Depois que você configura as tabelas e a aceleração de consulta opcional desejada, pode começar a analisar seus dados. Para consultar os dados, selecione a fonte de dados no menu suspenso. Se você estiver usando o Amazon S3 e os OpenSearch painéis, acesse Discover e selecione o nome da fonte de dados. 

Se estiver usando um índice de salto ou não tiver criado um índice, você poderá usar SQL ou PPL para consultar os dados. Se configurou uma visão materializada ou um índice de abrangência, você já tem um índice e pode usar a Dashboards Query Language (DQL) no Dashboards. Você também pode usar o PPL com o plug-in Observability e o SQL com o plug-in Query Workbench. Atualmente, somente os plug-ins Observability e Query Workbench oferecem suporte para PPL e SQL. Para consultar dados usando a API de OpenSearch serviço, consulte a documentação da API [assíncrona](https://github.com/opensearch-project/sql/blob/main/docs/user/interfaces/asyncqueryinterface.rst).

**nota**  
Nem todas as instruções, comandos e funções PPL são compatíveis. Para obter uma lista de comandos compatíveis, consulte [Comandos SQL e PPL compatíveis](direct-query-supported-commands.md).  
Se você criou uma visão materializada ou um índice abrangente, poderá usar DQL para consultar os dados fornecidos desde que os tenha indexado ali.

## Solução de problemas
<a name="s3-troubleshooting"></a>

Pode haver casos em que os resultados não retornem conforme o esperado. Se tiver enfrentando algum problema, lembre-se de seguir as [Recomendações](direct-query-s3-overview.md#direct-query-s3-recommendations).