Especificar um local para resultados de consultas - Amazon Athena

Especificar um local para resultados de consultas

O local de resultados de consultas usado pelo Athena é determinado por uma combinação de configurações de grupo de trabalho e do lado do cliente. As configurações do lado do cliente são baseadas na forma como você executa a consulta.

  • Se você executar a consulta usando o console do Athena, o Query result location (Local de resultados da consulta) inserido em Settings (Configurações) na barra de navegação determinará a configuração do lado do cliente.

  • Se você executar a consulta usando a API do Athena, o parâmetro OutputLocation da ação StartQueryExecution determinará a configuração do lado do cliente.

  • Se você usar os drivers ODBC ou JDBC para executar consultas, a propriedade S3OutputLocation especificada no URL de conexão determinará a configuração no lado do cliente.

Importante

Quando você executa uma consulta usando a API ou usando o driver ODBC ou JDBC, a configuração do console não se aplica.

Cada configuração de grupo de trabalho tem uma opção Override client-side settings (Substituir configurações no lado do cliente) que pode ser habilitada. Quando essa opção está habilitada, as configurações do grupo de trabalho têm precedência sobre as configurações aplicáveis do lado do cliente quando uma entidade principal do IAM associada a esse grupo de trabalho executa a consulta.

Sobre locais padrão já criados

Anteriormente no Athena, se você executasse uma consulta sem especificar um valor em Query result location (Local de resultados de consultas) e a configuração de local de resultados de consultas não fosse substituída por um grupo de trabalho, o Athena criava um local padrão para você. O local padrão era aws-athena-query-results-MyAcctID-MyRegion, em que MyAcctID era o ID da conta da Amazon Web Services do principal do IAM que executava a consulta, e MyRegion era a região em que a consulta era executada (por exemplo, us-west-1).

Agora, antes de executar uma consulta do Athena em uma região onde sua conta nunca acessou o Athena, você deve especificar um local de resultados de consultas ou usar um grupo de trabalho que substitua a configuração desse local. O Athena não cria mais um local padrão de resultados de consultas para você, mas os locais padrão aws-athena-query-results-MyAcctID-MyRegion que já foram criados permanecem válidos e você pode continuar a usá-los.