Atualizar um conector de fonte de dados

O Athena recomenda atualizar regularmente os conectores da fonte de dados que você usa para a versão mais recente para aproveitar os novos recursos e aprimoramentos. Para começar, é necessário localizar o número da versão mais recente.

Localizar a versão mais recente do Athena Query Federation

O número da versão mais recente dos conectores de fonte de dados do Athena corresponde à versão mais recente do Athena Query Federation. Em certos casos, as versões do GitHub podem ser um pouco mais recentes do que as disponíveis no AWS Serverless Application Repository (SAR).

Para localizar o número da versão mais recente do Athena Query Federation

1. Acesse o URL do GitHub https://github.com/awslabs/aws-athena-query-federation/releases/latest.

2. Observe o número da versão no título da página principal no seguinte formato:

   Versão v year.week_of_year.iteration_of_week do Athena Query Federation

   Por exemplo, o número da versão v2023.8.3 do Athena Query Federation é 2023.8.3.

Localizar e anotar nomes de recursos

Na preparação para o upgrade, é necessário localizar e anotar as seguintes informações:

1. O nome da função do Lambda para o conector.

2. As variáveis de ambiente da função do Lambda.

3. O nome da aplicação do Lambda, que gerencia a função do Lambda para o conector.

Para localizar nomes de recursos no console do Athena

1. Abra o console do Athena em https://console.aws.amazon.com/athena/.

2. Se o painel de navegação do console não estiver visível, escolha o menu de expansão à esquerda.

   

3. No painel de navegação, escolha Origens dos dados.

4. Na coluna Nome da fonte de dados, escolha o link para a fonte de dados do conector.

5. Na seção Detalhes da fonte de dados, em Função do Lambda, escolha o link para a função do Lambda.

   

6. Na página Funções, na coluna Nome da função, anote o nome da função do conector.

   

7. Escolha o link do nome da função.

8. Na seção Visão geral da função, escolha a guia Configuração.

9. No painel à esquerda, escolha Variáveis de ambiente.

10. Na seção Variáveis de ambiente, anote as chaves e os valores correspondentes.

11. Mova a barra de rolagem até o topo da página.

12. Na mensagem Esta função pertence a uma aplicação. Clique aqui para gerenciá-la, escolha o link Clique aqui.

13. Na página serverlessrepo-your_application_name, anote o nome da aplicação sem serverlessrepo. Por exemplo, se o nome da aplicação for serverlessrepo-DynamoDbTestApp, o nome da aplicação será DynamoDbTestApp.

14. Permaneça na página do console do Lambda de sua aplicação e continue com as etapas descritas em Localizar a versão do conector que você está usando.

Localizar a versão do conector que você está usando

Siga estas etapas para localizar a versão do conector que você está usando.

Para localizar a versão do conector que você está usando

1. Na página do console do Lambda de sua aplicação do Lambda, escolha a guia Implantações.

2. Na guia Implantações, expanda o Modelo do SAM.

3. Pesquise CodeUri.

4. No campo Chave, em CodeUri, localize a seguinte string:

   applications-connector_name-versions-year.week_of_year.iteration_of_week/hash_number

   O exemplo a seguir mostra uma string do conector do CloudWatch:

   applications-AthenaCloudwatchConnector-versions-2021.42.1/15151159...

5. Registre o valor de year.week_of_year.iteration_of_week (por exemplo, 2021.42.1). Esta é a versão de seu conector.

Implantar a nova versão de seu conector

Siga as etapas a seguir para implantar uma nova versão do conector.

Para implantar uma nova versão de seu conector

1. Abra o console do Athena em https://console.aws.amazon.com/athena/.

2. Se o painel de navegação do console não estiver visível, escolha o menu de expansão à esquerda.

   

3. No painel de navegação, escolha Origens dos dados.

4. Na página Data sources (Origens de dados), escolha Create data source (Criar origem dos dados).

5. Escolha a fonte de dados que deseja atualizar e escolha Próximo.

6. Na seção Detalhes da conexão, escolha Criar função do Lambda. Isso abre o console do Lambda, no qual você poderá implantar a aplicação atualizada.

   

7. Como você não está de fato criando uma nova fonte de dados, pode fechar a guia do console do Athena.

8. Na página do console do Lambda do conector, execute as seguintes etapas:

   1. Verifique se removeu o prefixo serverlessrepo- do nome da aplicação e copie o nome da aplicação no campo Nome da aplicação.

   2. Copie o nome da função do Lambda no campo AthenaCatalogName. Alguns conectores chamam esse campo de LambdaFunctionName.

   3. Copie as variáveis de ambiente que você registrou nos campos correspondentes.

9. Selecione a opção Eu reconheço que esta aplicação cria perfis do IAM personalizados e políticas de recursos e escolha Implantar.

10. Para verificar se a aplicação foi atualizada, escolha a guia Implantações.

    A seção Histórico de implantações mostra que sua atualização foi concluída.

    

11. Para confirmar o novo número da versão, você pode expandir Modelo do SAM como antes, localizar o CodeUri e verificar o número da versão do conector no campo Chave.

Agora é possível usar seu conector atualizado para criar consultas federadas do Athena.