# Usar a consulta federada do Amazon Athena
<a name="federated-queries"></a>

Se você tiver dados em fontes diferentes do Amazon S3, poderá usar a consulta federada do Athena para consultá-los no local ou criar pipelines para extrair os dados de várias fontes de dados e armazená-los no Amazon S3. Com a consulta federada do Athena, é possível executar consultas SQL nos dados armazenados em origens relacionais, não relacionais, de objetos e personalizadas. Para obter uma lista completa das fontes de dados suportadas, consulte [Conectores de fonte de dados disponíveis](connectors-available.md). 

Quando uma consulta é realizada em uma fonte de dados, o Athena invoca o conector para determinar quais dados serão lidos, gerencia o paralelismo e envia os predicados de filtro. Os conectores também podem restringir o acesso aos dados com base no usuário que envia a consulta.

O Athena usa *conectores de fonte de dados* para executar as consultas federadas nos dados subjacentes. O Athena é compatível com dois tipos de conectores de fonte de dados com recursos diferentes: 
+ **Conectores federados do AWS Glue Data Catalog** – Esses conectores usam uma conexão do AWS Glue para se conectar à fonte de dados. Eles podem ser usados com suporte ao controle refinado de governança de dados por meio do Lake Formation. Para obter mais informações, consulte [Conexões de dados do catálogo federado](https://docs.aws.amazon.com/lake-formation/latest/dg/federated-catalog-data-connection.html) no *Guia do desenvolvedor do AWS Lake Formation*. 
  + Os conectores associados a um Lambda podem, opcionalmente, ser registrados manualmente como um AWS Glue Data Catalog para serem usados com o Lake Formation para proporcionar uma governança de dados refinada. 
  + Desde 21 de abril de 2026, alguns conectores recém-criados são registrados automaticamente como catálogos de dados do Glue e não usam uma função do Lambda em sua conta da AWS. 
+ **Conectores federados do catálogo de dados do Athena** – Esses conectores são específicos do Athena e não podem ser registrados como catálogos federados com AWS Glue Data Catalog. Eles exigem uma função do Lambda na sua conta da AWS. Os conectores personalizados desenvolvidos com o uso do SDK de federação de consultas do Athena são conectores do catálogo de dados do Athena. Para obter mais informações, consulte [Desenvolver um conector de fonte de dados com uso do SDK do Athena Query Federation](connect-data-source-federation-sdk.md). 

Para obter uma lista de fontes de dados compatíveis com cada tipo, consulte [Suporte ao tipo de conector por fonte de dados](#federated-queries-connector-support).

**nota**  
Desenvolvedores de terceiro podem ter usado o Athena Query Federation SDK para escrever conectores de origem dos dados. Para problemas de suporte ou licenciamento com esses conectores de origem dos dados, entre em contato com o provedor dos conectores. Esses conectores não foram testados nem contam com suporte da AWS. 

## Considerações e limitações
<a name="connect-to-a-data-source-considerations"></a>
+ **Visualizações**: é possível criar e consultar visualizações em fontes de dados federadas. As visualizações federadas são armazenadas no AWS Glue, não na fonte de dados subjacente. Para obter mais informações, consulte [Consultar visualizações federadas](running-federated-queries.md#running-federated-queries-federated-views).
+ **Identificadores delimitados**: os identificadores delimitados (também conhecidos como identificadores citados) começam e terminam com aspas ("). Atualmente, não há compatibilidade com identificadores delimitados para consultas federadas no Athena.
+ **Operações de gravação**: operações de gravação como [INSERT INTO](insert-into.md) não são suportadas. Tentar fazer isso pode gerar a mensagem de erro: This operation is currently not supported for external catalogs (Atualmente, esta operação não é suportada para catálogos externos).
+  **Preço**: para obter informações de preço, consulte [Preços do Amazon Athena](https://aws.amazon.com/athena/pricing/).
+ **Driver JDBC**: para usar o driver JDBC com consultas federadas ou um [metastore externo do Hive](connect-to-data-source-hive.md), inclua `MetadataRetrievalMethod=ProxyAPI` na string de conexão JDBC. Para obter informações sobre o driver JDBC, consulte [Conectar ao Amazon Athena com JDBC](connect-with-jdbc.md). 
+ **Secrets Manager**: para usar o recurso de consulta federada do Athena com AWS Secrets Manager, você deve configurar um endpoint privado do Amazon VPC para o Secrets Manager. Para obter mais informações, consulte [Criação de um endpoint privado da VPC para o Secrets Manager](https://docs.aws.amazon.com/secretsmanager/latest/userguide/vpc-endpoint-overview.html#vpc-endpoint-create) no *Guia do usuário do AWS Secrets Manager*.
+ **Consultas de passagem** – As consultas de passagem não são suportadas depois que uma fonte de dados é registrada como AWS Glue Data Catalog.

## Suporte ao tipo de conector por fonte de dados
<a name="federated-queries-connector-support"></a>

A tabela a seguir mostra os tipos de conectores que cada fonte de dados suporta. Alguns conectores do catálogo federado do AWS Glue Data Catalog criados a partir de 21 de abril de 2026 não exigem o Lambda.


<table>
<thead>
  <tr><th>Fonte de dados</th><th colspan="2">Conectores federados do AWS Glue Data Catalog</th><th>Conectores federados do catálogo de dados do Athena</th></tr>
  <tr><th></th><th>Sem Lambda</th><th>Com Lambda</th><th></th></tr>
</thead>
<tbody>
  <tr><td>[Amazon CloudWatch Logs](connectors-cloudwatch.md)</td><td></td><td>Sim</td><td>Sim</td></tr>
  <tr><td>[Métricas do Amazon CloudWatch](connectors-cwmetrics.md)</td><td></td><td>Sim</td><td>Sim</td></tr>
  <tr><td>[Amazon DocumentDB](connectors-docdb.md)</td><td>Sim</td><td>Sim</td><td>Sim</td></tr>
  <tr><td>[Amazon DynamoDB](connectors-dynamodb.md)</td><td>Sim</td><td>Sim</td><td>Sim</td></tr>
  <tr><td>[Amazon MSK](connectors-msk.md)</td><td></td><td></td><td>Sim</td></tr>
  <tr><td>[Amazon Neptune](connectors-neptune.md)</td><td></td><td></td><td>Sim</td></tr>
  <tr><td>[Amazon OpenSearch](connectors-opensearch.md)</td><td>Sim</td><td>Sim</td><td>Sim</td></tr>
  <tr><td>[Amazon Redshift](connectors-redshift.md)</td><td>Sim</td><td>Sim</td><td>Sim</td></tr>
  <tr><td>[Amazon Timestream](connectors-timestream.md)</td><td></td><td>Sim</td><td>Sim</td></tr>
  <tr><td>[Azure Data Lake Storage](connectors-adls-gen2.md)</td><td></td><td>Sim</td><td>Sim</td></tr>
  <tr><td>[Azure Synapse](connectors-azure-synapse.md)</td><td></td><td>Sim</td><td>Sim</td></tr>
  <tr><td>[Cloudera Hive](connectors-cloudera-hive.md)</td><td></td><td>Sim</td><td>Sim</td></tr>
  <tr><td>[Cloudera Impala](connectors-cloudera-impala.md)</td><td></td><td>Sim</td><td>Sim</td></tr>
  <tr><td>[CMDB](connectors-cmdb.md)</td><td></td><td>Sim</td><td>Sim</td></tr>
  <tr><td>[Confluent](connectors-kafka.md)</td><td></td><td></td><td>Sim</td></tr>
  <tr><td>[Personalizada](connect-data-source-federation-sdk.md)</td><td></td><td></td><td>Sim</td></tr>
  <tr><td>[Db2](connectors-ibm-db2.md)</td><td></td><td>Sim</td><td>Sim</td></tr>
  <tr><td>[Db2 iSeries](connectors-ibm-db2-as400.md)</td><td></td><td>Sim</td><td>Sim</td></tr>
  <tr><td>[Google BigQuery](connectors-bigquery.md)</td><td>Sim</td><td>Sim</td><td>Sim</td></tr>
  <tr><td>[Google Cloud Storage](connectors-gcs.md)</td><td></td><td>Sim</td><td>Sim</td></tr>
  <tr><td>[HBase](connectors-hbase.md)</td><td></td><td>Sim</td><td>Sim</td></tr>
  <tr><td>[Hortonworks (Hive)](connectors-hortonworks.md)</td><td></td><td></td><td>Sim</td></tr>
  <tr><td>[Kafka](connectors-kafka.md)</td><td></td><td></td><td>Sim</td></tr>
  <tr><td>[MySQL](connectors-mysql.md)</td><td>Sim</td><td>Sim</td><td>Sim</td></tr>
  <tr><td>[Oracle](connectors-oracle.md)</td><td>Sim</td><td>Sim</td><td>Sim</td></tr>
  <tr><td>[PostgreSQL](connectors-postgresql.md)</td><td>Sim</td><td>Sim</td><td>Sim</td></tr>
  <tr><td>[Redis OSS](connectors-redis.md)</td><td></td><td></td><td>Sim</td></tr>
  <tr><td>[SAP HANA](connectors-sap-hana.md)</td><td>Sim</td><td>Sim</td><td>Sim</td></tr>
  <tr><td>[Snowflake](connectors-snowflake.md)</td><td>Sim</td><td>Sim</td><td>Sim</td></tr>
  <tr><td>[do SQL Server](connectors-microsoft-sql-server.md)</td><td>Sim</td><td>Sim</td><td>Sim</td></tr>
  <tr><td>[Teradata](connectors-teradata.md)</td><td>Sim</td><td>Sim</td><td>Sim</td></tr>
  <tr><td>[TPC-DS](connectors-tpcds.md)</td><td></td><td>Sim</td><td>Sim</td></tr>
  <tr><td>[Vertica](connectors-vertica.md)</td><td></td><td>Sim</td><td>Sim</td></tr>
</tbody>
</table>


## Vídeos
<a name="connect-to-a-data-source-videos"></a>

Assista aos vídeos a seguir para saber mais como usar a consulta federada do Athena.

**Vídeo: analisar os resultados da consulta federada do Amazon Athena no Quick**  
O vídeo a seguir demonstra como analisar os resultados de uma consulta federada do Athena no Quick.

[![AWS Videos](http://img.youtube.com/vi/HyM5d0TmwAQ/0.jpg)](http://www.youtube.com/watch?v=HyM5d0TmwAQ)


**Vídeo: Game Analytics Pipeline**  
O vídeo a seguir mostra como implantar um pipeline de dados escalável sem servidor para ingerir, armazenar e analisar dados de telemetria de jogos e serviços usando as consultas federadas do Amazon Athena.

[![AWS Videos](http://img.youtube.com/vi/xcS-flUMVbs/0.jpg)](http://www.youtube.com/watch?v=xcS-flUMVbs)