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

# Etapa 1: Crie o bucket do Amazon S3, baixe as ferramentas necessárias e configure o ambiente
<a name="S3-tutorial-step1"></a>

Nesta etapa, você baixa as ferramentas externas e cria e configura os AWS recursos necessários para a solução automatizada de exportação de dados de uma tabela do Amazon Keyspaces para um bucket do Amazon S3 usando um trabalho. AWS Glue Para realizar todas essas tarefas de forma eficiente, executamos um script de shell com o nome `setup-connector.sh` disponível no [Github.](https://github.com/aws-samples/amazon-keyspaces-examples/blob/main/scala/datastax-v4/aws-glue/setup-connector.sh)

O script `setup-connector.sh` automatiza as etapas a seguir.

1. Cria um **bucket do Amazon S3 usando**. CloudFormation Esse bucket armazena os arquivos jar e de configuração baixados, bem como os dados da tabela exportada.

1. Cria uma **função do IAM** usando CloudFormation. AWS Glue os trabalhos usam essa função para acessar o Amazon Keyspaces e o Amazon S3.

1. Faz o download do [conector Apache Spark Cassandra](https://repo1.maven.org/maven2/com/datastax/spark/) e o carrega no bucket do Amazon S3.

1. Faz o download do [plug-in de autenticação SigV4](https://repo1.maven.org/maven2/software/aws/mcs/aws-sigv4-auth-cassandra-java-driver-plugin/) e o carrega no bucket do Amazon S3.

1. Faz o download das [extensões do Apache Spark e as](https://repo1.maven.org/maven2/uk/co/gresearch/spark/) carrega no bucket do Amazon S3.

1. Faz o download da [Keyspaces Retry Policy](https://github.com/aws-samples/amazon-keyspaces-java-driver-helpers) do Github, compila o código usando o Maven e carrega a saída para o bucket do Amazon S3.

1. Carrega o **`keyspaces-application.conf`**arquivo no bucket do Amazon S3.

**Use o script de `setup-connector.sh` shell para automatizar as etapas de instalação e configuração.**

1. Copie os arquivos do repositório [aws-glue](https://github.com/aws-samples/amazon-keyspaces-examples/blob/main/scala/datastax-v4/aws-glue) no Github para sua máquina local. Esse diretório contém o script do shell, bem como outros arquivos necessários.

1. Execute o script do shell`setup-connector.sh`. Você pode especificar os três parâmetros opcionais a seguir.

   1. `SETUP_STACKNAME`— Esse é o nome da CloudFormation pilha usada para criar os AWS recursos.

   1. `S3_BUCKET_NAME`— Esse é o nome do bucket do Amazon S3.

   1. `GLUE_SERVICE_ROLE_NAME`— Esse é o nome da função de serviço do IAM AWS Glue usada para executar trabalhos que se conectam ao Amazon Keyspaces e ao Amazon S3.

   Você pode usar o comando a seguir para executar o script de shell e fornecer os três parâmetros com os nomes a seguir.

   ```
   ./setup-connector.sh {{cfn-setup}} {{s3-keyspaces}} {{iam-export-role}}
   ```

   Para confirmar que seu bucket foi criado, você pode usar o AWS CLI comando a seguir.

   ```
   aws s3 ls s3://s3-keyspaces
   ```

   A saída do comando deve ter a seguinte aparência.

   ```
                              PRE conf/
                              PRE jars/
   ```

   Para confirmar que a função do IAM foi criada e analisar os detalhes, você pode usar a seguinte AWS CLI declaração.

   ```
   aws iam get-role --role-name "iam-export-role"
   ```

   ```
   {
       "Role": {
           "Path": "/",
           "RoleName": "iam-export-role",
           "RoleId": "AKIAIOSFODNN7EXAMPLE",
           "Arn": "arn:aws:iam::111122223333:role/iam-export-role",
           "CreateDate": "2025-01-28T16:09:03+00:00",
           "AssumeRolePolicyDocument": {
               "Version": "2012-10-17",		 	 	 
               "Statement": [
                   {
                       "Effect": "Allow",
                       "Principal": {
                           "Service": "glue.amazonaws.com"
                       },
                       "Action": "sts:AssumeRole"
                   }
               ]
           },
           "Description": "AWS Glue service role to import and export data from Amazon Keyspaces",
           "MaxSessionDuration": 3600,
           "RoleLastUsed": {
               "LastUsedDate": "2025-01-29T12:03:54+00:00",
               "Region": "us-east-1"
           }
       }
   }
   ```

Se o processo de CloudFormation empilhamento falhar, você poderá revisar as informações de erro detalhadas sobre a pilha com falha no CloudFormation console.

Depois que o bucket do Amazon S3 contendo todos os scripts e ferramentas for criado e a função do IAM estiver configurada, prossiga para. [Etapa 2: Configurar o AWS Glue trabalho que exporta a tabela Amazon Keyspaces](S3-tutorial-step2.md)