Criar tarefas de exportação do cluster de banco de dados - Amazon Aurora

Criar tarefas de exportação do cluster de banco de dados

Crie tarefas de exportação para exportar dados do cluster de banco de dados do Aurora para um bucket do Amazon S3. Você pode ter até cinco tarefas de exportação de cluster de banco de dados simultâneas em andamento por Conta da AWS.

nota

A exportação dos dados do cluster de banco de dados pode levar um tempo, dependendo do tipo e do tamanho do banco de dados. A tarefa de exportação primeiro clona e escala todo o banco de dados antes de extrair os dados para o Amazon S3. O andamento da tarefa durante essa fase é exibido como Starting (Iniciando). Quando a tarefa muda para a exportação de dados para o S3, o andamento é exibido como In progress (Em andamento).

O tempo necessário para que a exportação seja concluída depende dos dados armazenados no banco de dados. Por exemplo, tabelas com chaves primárias numéricas bem distribuída ou colunas de índice serão exportadas de maneira mais rápida. As tabelas que não contêm uma coluna adequada para particionamento e as tabelas com somente um índice em uma coluna baseada em string levam mais tempo porque a exportação usa um processo em thread único mais lento.

Você pode exportar os dados de cluster de banco de dados para o Amazon S3 usando o AWS Management Console, a AWS CLI ou a API do RDS.

Se você usar uma função do Lambda para exportar os dados do cluster de banco de dados, adicione a ação kms:DescribeKey à política da função do Lambda. Para ter mais informações, consulte Permissões doAWS Lambda.

A opção do console Export to Amazon S3 (Exportar para o Amazon S3) é exibido somente para clusters de banco de dados que podem ser exportados para o Amazon S3. Um cluster de banco de dados pode não estar disponível para exportação devido aos seguintes motivos:

  • O mecanismo de banco de dados não tem suporte para exportação do S3.

  • A versão do cluster de banco de dados não é compatível com a exportação do S3.

  • A exportação do S3 não é aceita na região da AWS onde o cluster de banco de dados foi criado.

Como exportar dados do cluster de banco de dados

  1. Faça login no AWS Management Console e abra o console do Amazon RDS em https://console.aws.amazon.com/rds/.

  2. No painel de navegação, escolha Bancos de dados.

  3. Selecione o cluster de banco de dados cujos dados você deseja exportar.

  4. Em Actions (Ações), escolha Export to Amazon S3 (Exportar para o Amazon S3).

    A janela Export to Amazon S3 (Exportar para o Amazon S3) é exibida.

  5. Em Export identifier (Identificador de exportação), insira um nome para identificar a tarefa de exportação. Esse valor também é usado para o nome do arquivo criado no bucket do S3.

  6. Escolha os dados a serem exportados:

    • Selecione All (Todos) para exportar todos os dados do cluster de banco de dados.

    • Selecione Partial (Parcial) para exportar partes específicas do cluster de banco de dados. Para identificar quais partes do cluster exportar, insira um ou mais bancos de dados, esquemas ou tabelas para Identifiers (Identificadores), separados por espaços.

      Use o formato a seguir:

      database[.schema][.table] database2[.schema2][.table2] ... databasen[.scheman][.tablen]

      Por exemplo:

      mydatabase mydatabase2.myschema1 mydatabase2.myschema2.mytable1 mydatabase2.myschema2.mytable2

  7. Em S3 bucket (Bucket do S3), escolha o bucket para o qual exportar.

    Para atribuir os dados exportados a um caminho de pasta no bucket do S3, insira o caminho opcional para o S3 prefix (Prefixo do S3).

  8. Em IAM role (Perfil do IAM), escolha um perfil que conceda a você acesso de gravação ao bucket do S3 escolhido ou crie um novo perfil.

    • Se você criou um perfil seguindo as etapas em Fornecer acesso a um bucket do Amazon S3 usando um perfil do IAM, escolha esse perfil.

    • Se você não criou um perfil que conceda acesso de gravação ao bucket do S3 escolhido, selecione Create a new role (Criar um perfil) para criar o perfil automaticamente. Depois, insira um nome para o perfil em Nome do perfil do IAM.

  9. Em KMS key (Chave do KMS), insira o ARN da chave a ser usada para criptografar os dados exportados.

  10. Escolha Export to Amazon S3 (Exportar para o Amazon S3).

Para exportar dados do cluster de banco de dados para o Amazon S3 usando a AWS CLI, use o comando start-export-task com as seguintes opções necessárias:

  • --export-task-identifier

  • --source-arn: o nome do recurso da Amazon (ARN) do cluster de banco de dados

  • --s3-bucket-name

  • --iam-role-arn

  • --kms-key-id

Nos exemplos a seguir, a tarefa de exportação é chamada my-cluster-export, que exporta os dados para um bucket do S3 chamado amzn-s3-demo-destination-bucket.

Para Linux, macOS ou Unix:

aws rds start-export-task \
    --export-task-identifier my-cluster-export \
    --source-arn arn:aws:rds:us-west-2:123456789012:cluster:my-cluster \
    --s3-bucket-name amzn-s3-demo-destination-bucket \
    --iam-role-arn iam-role \
    --kms-key-id my-key

Para Windows:

aws rds start-export-task ^
    --export-task-identifier my-DB-cluster-export ^
    --source-arn arn:aws:rds:us-west-2:123456789012:cluster:my-cluster ^
    --s3-bucket-name amzn-s3-demo-destination-bucket ^
    --iam-role-arn iam-role ^
    --kms-key-id my-key

Segue um exemplo de saída.

{
    "ExportTaskIdentifier": "my-cluster-export",
    "SourceArn": "arn:aws:rds:us-west-2:123456789012:cluster:my-cluster",
    "S3Bucket": "amzn-s3-demo-destination-bucket",
    "IamRoleArn": "arn:aws:iam:123456789012:role/ExportTest",
    "KmsKeyId": "my-key",
    "Status": "STARTING",
    "PercentProgress": 0,
    "TotalExtractedDataInGB": 0,
}

Para fornecer um caminho de pasta no bucket do S3 para a exportação do cluster de banco de dados, inclua a opção --s3-prefix no comando start-export-task.

Para exportar dados do cluster de banco de dados para o Amazon S3 usando a API do Amazon RDS, use a operação StartExportTask com os seguintes parâmetros necessários:

  • ExportTaskIdentifier

  • SourceArn: o ARN do cluster de banco de dados

  • S3BucketName

  • IamRoleArn

  • KmsKeyId