Visão geral de importação e exportação do Spanner

Visão geral

A funcionalidade de importação e exportação do Spanner ajuda você a mover dados em massa para dentro ou para fora dos bancos de dados do Spanner usando o Dataflow. É possível exportar qualquer banco de dados do Spanner para um bucket do Cloud Storage usando os formatos de arquivo Avro ou CSV. Também é possível importar dados de arquivos Avro ou CSV para um novo banco de dados do Spanner.

Casos de uso

Os casos de uso das funções de importação e exportação incluem:

  • Carregamento em massa: use a funcionalidade de importação para carregar dados em massa no Spanner.

  • Backup e arquivamento de longo prazo: é possível exportar seu banco de dados a qualquer momento e armazená-lo em um local de bucket do Cloud Storage de sua escolha para backup ou arquivamento de longo prazo. Além disso, é possível usar a recuperação pontual para exportar um banco de dados de um carimbo de data/hora passado específico.

    Observe que o Spanner também oferece backup e restauração gerenciados para casos de uso de recuperação de desastres mais rápidos.

  • Copiar bancos de dados para projetos de desenvolvimento ou teste: é possível exportar um banco de dados de um projeto de produção e importá-lo para o projeto de desenvolvimento ou teste para usar em testes de integração ou outros experimentos.

  • Ingestão para análise: use a exportação de banco de dados para ingerir seus dados operacionais em massa para serviços de análise como o BigQuery. O BigQuery pode ingerir dados automaticamente no formato Avro de um bucket do Cloud Storage, facilitando a execução de análises nos dados operacionais.

    Se você quiser usar o BigQuery para análise em tempo real dos dados do Spanner sem a necessidade de copiar ou mover esses dados, use as consultas federadas do Spanner.

Comparação de formatos de arquivo

A tabela a seguir compara as diferenças de recursos entre os formatos de arquivo Avro e CSV ao importar e exportar dados do Spanner.

Para instruções detalhadas sobre como importar ou exportar para esses formatos, incluindo informações sobre limitações aplicáveis, consulte Próximas etapas abaixo.

Capacidade Formato Avro Formato CSV
Importar ou exportar um banco de dados inteiro Sim Não
Capacidade de exportar apenas tabelas selecionadas em um banco de dados Sim* Sim†
Capacidade de importar tabelas/tabelas exportadas anteriormente Sim* Sim†
Exportar em um carimbo de data/hora no passado Sim Sim
Importar ou exportar usando a Google Cloud CLI Sim Sim
Importe ou exporte usando a página do Dataflow no console do Google Cloud Sim Sim
Importe ou exporte usando a página do Spanner do console do Google Cloud Sim* Não

* Consulte "Observações sobre importação e exportação do Avro" abaixo.
† Consulte "Observações sobre importação e exportação de CSV" abaixo.

Observações sobre importação e exportação do Avro

Ao exportar para o formato Avro, é possível especificar uma lista de tabelas para exportação. Todas as tabelas filhas exportadas dessa maneira precisam ser acompanhadas pelas respectivas tabelas pai. O Spanner mantém todo o esquema do banco de dados nos arquivos exportados.

Na importação do formato Avro, o Spanner recria todo o esquema do banco de dados exportado, incluindo todas as tabelas. As tabelas incluídas na exportação original recebem todos os dados exportados. Todas as outras permanecem vazias.

A página do Spanner do console do Google Cloud oferece opções limitadas de importação e exportação em formato Avro. Por exemplo, ele não disponibiliza opções de rede e sub-rede. Para um conjunto mais amplo de opções, use a página do Dataflow.

Observações sobre importação e exportação de CSV

O Spanner limita a exportação de uma única tabela por vez no formato CSV. Na exportação, o esquema não é exportado, apenas os dados são exportados.

Antes de importar de arquivos CSV, você precisa criar um manifesto JSON manualmente.

Preços

Não há cobranças extras do Spanner pelo uso das ferramentas de exportação ou importação. Você paga as taxas padrão para armazenamento de dados ao importar um banco de dados para o Spanner. No entanto, há outros custos potenciais associados à importação e exportação de bancos de dados. Consulte a página de pricing do Spanner para saber mais.

A seguir