Restaurar uma tabela do backup para um ponto específico no tempo no Amazon Keyspaces - Amazon Keyspaces (para Apache Cassandra)

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

Restaurar uma tabela do backup para um ponto específico no tempo no Amazon Keyspaces

A seção a seguir demonstra como restaurar uma tabela existente do Amazon Keyspaces em um momento específico.

nota

Esse procedimento pressupõe que a tabela que você está usando tenha sido configurada com point-in-time recuperação. PITRPara habilitar uma tabela, consulteConfigurar PITR para uma tabela no Amazon Keyspaces.

Importante

Enquanto uma restauração estiver em andamento, não modifique nem exclua o AWS Identity and Access Management (IAM) políticas que concedem permissão ao IAM principal (por exemplo, usuário, grupo ou função) para realizar a restauração. Do contrário, pode haver um comportamento inesperado. Por exemplo, se você remover as permissões de gravação de uma tabela enquanto a tabela estiver sendo restaurada, a RestoreTableToPointInTime operação subjacente não poderá gravar nenhum dado restaurado na tabela.

Você pode modificar ou excluir permissões somente após a conclusão da operação de restauração.

Console
Restaurar uma tabela em um ponto específico no tempo usando o console

  1. Faça login no AWS Management Consolee abra o console do Amazon Keyspaces em casahttps://console.aws.amazon.com/keyspaces/.

  2. No painel de navegação, no lado esquerdo do console, selecione Tables (Tabelas).

  3. Na lista de tabelas, escolha a tabela que você deseja restaurar.

  4. Na guia Backups da tabela, na seção oint-in-time Recuperação P, escolha Restaurar.

  5. Para o novo nome da tabela, insira um novo nome para a tabela restaurada, por exemplomytable_restored.

  6. Para definir o ponto no tempo da operação de restauração, você pode escolher entre duas opções:

    • Selecione a hora Mais antiga pré-configurada.

    • Selecione Especificar data e hora e insira a data e a hora para as quais você deseja restaurar a nova tabela.

    nota

    É possível fazer a restauração para qualquer ponto no tempo dentro da hora Mais antiga e da hora atual. O Amazon Keyspaces restaura os dados da tabela para o estado com base na data e na hora selecionadas (dia:hora:minuto:segundo).

  7. Selecione Restaurar para iniciar o processo de restauração.

    A tabela que está sendo restaurada é mostrada com o status Restoring (Em restauração). Depois que o processo de restauração for concluído, o status da tabela restaurada será alterado para Ativo.

Cassandra Query Language (CQL)
Restaurar uma tabela para um ponto no tempo usando CQL

  1. Você pode restaurar uma tabela ativa para uma hora point-in-time entre earliest_restorable_timestamp e a hora atual. O padrão é a hora atual.

    Para confirmar se a point-in-time recuperação está habilitada para a tabela, consulte o system_schema_mcs.tables conforme mostrado neste exemplo.

    SELECT custom_properties
FROM system_schema_mcs.tables
WHERE keyspace_name = 'mykeyspace' AND table_name = 'mytable';

    A oint-in-time recuperação P está ativada conforme mostrado no exemplo de saída a seguir. 

    custom_properties
-----------------
{
  ...,
    "point_in_time_recovery": {
    "earliest_restorable_timestamp":"2020-06-30T19:19:21.175Z"
    "status":"enabled"
  }
}

    • Restaure a tabela para a hora atual. Quando você omite a WITH restore_timestamp = ... cláusula, o carimbo de data/hora atual é usado. 

      RESTORE TABLE mykeyspace.mytable_restored
FROM TABLE mykeyspace.mytable;

    • Você também pode restaurar para um ponto específico no tempo, definido pelo formato restore_timestamp ISO 8601. Você pode especificar qualquer ponto durante os últimos 35 dias. Por exemplo, o comando a seguir restaura a tabela para o EarliestRestorableDateTime. 

      RESTORE TABLE mykeyspace.mytable_restored
FROM TABLE mykeyspace.mytable
WITH restore_timestamp = '2020-06-30T19:19:21.175Z';

      Para obter uma descrição completa da sintaxe, consulte RESTORE TABLE na referência de linguagem.

  3. Para verificar se a restauração da tabela foi bem-sucedida, consulte o system_schema_mcs.tables para confirmar o status da tabela.

    SELECT status
FROM system_schema_mcs.tables
WHERE keyspace_name = 'mykeyspace' AND table_name = 'mytable_restored'

    A consulta mostra o a saída a seguir.

    status
------
RESTORING

    A tabela que está sendo restaurada é mostrada com o status Restoring (Em restauração). Depois que o processo de restauração for concluído, o status da tabela será alterado para Ativo.

CLI
Restaure uma tabela para um determinado momento usando o AWS CLI

  1. Crie uma tabela simples chamada myTable que tenha sido PITR ativada. O comando foi dividido em linhas separadas para facilitar a leitura.

    aws keyspaces create-table --keyspace-name 'myKeyspace' --table-name 'myTable' 
            --schema-definition 'allColumns=[{name=id,type=int},{name=name,type=text},{name=date,type=timestamp}],partitionKeys=[{name=id}]' 
            --point-in-time-recovery 'status=ENABLED'

  2. Confirme as propriedades da nova tabela e revise earliestRestorableTimestamp o formulárioPITR.

    aws keyspaces get-table --keyspace-name 'myKeyspace' --table-name 'myTable'

    A saída deste comando retorna o seguinte.

    {
    "keyspaceName": "myKeyspace",
    "tableName": "myTable",
    "resourceArn": "arn:aws:cassandra:us-east-1:111222333444:/keyspace/myKeyspace/table/myTable",
    "creationTimestamp": "2022-06-20T14:34:57.049000-07:00",
    "status": "ACTIVE",
    "schemaDefinition": {
        "allColumns": [
            {
                "name": "id",
                "type": "int"
            },
            {
                "name": "date",
                "type": "timestamp"
            },
            {
                "name": "name",
                "type": "text"
            }
        ],
        "partitionKeys": [
            {
                "name": "id"
            }
        ],
        "clusteringKeys": [],
        "staticColumns": []
    },
    "capacitySpecification": {
        "throughputMode": "PAY_PER_REQUEST",
        "lastUpdateToPayPerRequestTimestamp": "2022-06-20T14:34:57.049000-07:00"
    },
    "encryptionSpecification": {
        "type": "AWS_OWNED_KMS_KEY"
    },
    "pointInTimeRecovery": {
        "status": "ENABLED",
        "earliestRestorableTimestamp": "2022-06-20T14:35:13.693000-07:00"
    },
    "defaultTimeToLive": 0,
    "comment": {
        "message": ""
    }
}

    • Para restaurar uma tabela em um momento específico, especifique a restore_timestamp no formato ISO 8601. É possível escolher qualquer ponto no tempo durante os últimos 35 dias em intervalos de um segundo. Por exemplo, o comando a seguir restaura a tabela para o EarliestRestorableDateTime. 

      aws keyspaces restore-table --source-keyspace-name 'myKeyspace' --source-table-name 'myTable' --target-keyspace-name 'myKeyspace' --target-table-name 'myTable_restored' --restore-timestamp "2022-06-20 21:35:14.693"

      A saída desse comando retorna a ARN da tabela restaurada.

      {
    "restoredTableARN": "arn:aws:cassandra:us-east-1:111222333444:/keyspace/myKeyspace/table/myTable_restored"
}

    • Para restaurar a tabela para a hora atual, você pode omitir o restore-timestamp parâmetro.

      aws keyspaces restore-table --source-keyspace-name 'myKeyspace' --source-table-name 'myTable' --target-keyspace-name 'myKeyspace' --target-table-name 'myTable_restored1'"