Data Management:Exportar conjuntos de resultados SQL

Pré-requisitos

• O banco de dados deve ser de um dos seguintes tipos:

  Tipo de banco de dados

  • Banco de dados relacional:

    • MySQL: ApsaraDB RDS for MySQL, PolarDB for MySQL, MyBase for MySQL, PolarDB-X e bancos de dados MySQL de outras fontes

    • SQL Server: ApsaraDB RDS for SQL Server, MyBase for SQL Server e bancos de dados SQL Server de outras fontes

    • PostgreSQL: ApsaraDB RDS for PostgreSQL, PolarDB for PostgreSQL, MyBase for PostgreSQL e bancos de dados PostgreSQL de outras fontes

    • MariaDB: ApsaraDB RDS for MariaDB e bancos de dados MariaDB de outras fontes

    • OceanBase: OceanBase in MySQL mode, OceanBase in Oracle mode e OceanBase autogerenciado

    • PolarDB for PostgreSQL (Oracle-compatible)

    • Oracle

    • Dameng

    • Db2

  • NoSQL: MongoDB, Lindorm, Cassandra

  • Data warehouse: AnalyticDB for MySQL, AnalyticDB for PostgreSQL, DLA, ClickHouse, MaxCompute e Hologres

• Você registrou a instância do banco de dados de destino no DMS.

Notas de uso

• Os limites para exportação de um conjunto de resultados SQL, como o número de linhas exportáveis gratuitamente e o tamanho máximo da tabela para uma única exportação, variam de acordo com o modo de controle.

• Para exportar dados de outro banco de dados na mesma instância, faça login no DMS com uma conta de privilégios elevados para evitar erros de permissão.

• Para bancos de dados lógicos, o tamanho máximo de exportação é de 512 MB. Os dados que excederem esse limite serão truncados.

Procedimento

1. Faça login no DMS 5.0.

2. Na barra de navegação superior, escolha Database Development > Data Export > SQL Result Set Export.

   Nota

   Para bancos de dados que não sejam NoSQL, execute também uma instrução SQL na janela SQL Console e escolha Export File > Export more data na guia de resultados e crie um ticket de exportação de dados.

3. Configure os parâmetros do ticket de exportação de dados.

   Nota

   O exemplo a seguir utiliza uma instância do ApsaraDB RDS for MySQL no modo de controle Security Collaboration. Os parâmetros podem variar um pouco para outros tipos de banco de dados.

   Parâmetro	Obrigatório	Descrição
   Database name	Sim	Selecione o banco de dados de destino. Nota Você precisa ter as permissões necessárias para exportar dados do banco de dados. Para mais informações, consulte Visualizar minhas permissões.
   Reason category	Sim	Selecione um motivo para a exportação de dados. Essa escolha facilita o rastreamento futuro do ticket.
   Business background	Sim	Descreva detalhadamente o motivo ou a finalidade da exportação de dados para reduzir a sobrecarga de comunicação.
   Affected rows	Sim	Para estimar o número de linhas de dados afetadas por esta exportação, use o comando count no SQL Console. Nota Durante a fase de pré-verificação, o sistema exibe o número real de linhas afetadas. Verifique se esse número atende às suas expectativas e identifique anomalias para evitar incidentes de segurança de dados.
   Skip validation	Não	Define se o processo de validação será ignorado. Caso selecione Skip Validation, você também deverá fornecer um motivo. Aviso Se você selecionar Skip Validation, o DMS não verificará o número de linhas afetadas. A exportação de um grande volume de dados pode apresentar riscos ao seu negócio. Prossiga com cautela.
   Stakeholders	Não	Os usuários especificados como partes interessadas podem visualizar e colaborar no ticket. Usuários não especificados (exceto administradores e DBAs) não podem visualizar o ticket.
   Export SQL statement	Sim	Insira uma instrução SQL executável diretamente, como SELECT * FROM testtable. Envie a solicitação. O DMS verifica a sintaxe automaticamente. Não é possível enviá-la se a sintaxe estiver incorreta. Nota Apenas instruções de consulta SELECT são compatíveis.
   Embed watermark	Sim	Define se uma marca d'água será incorporada ao arquivo exportado. Yes: Incorpora uma marca d'água no arquivo exportado. No: Não incorpora uma marca d'água.
   Embedding method	Sim	Selecione um método de incorporação: Data watermark: Incorpora informações de identificação nos dados. Essa marca d'água não é facilmente perceptível aos usuários. File watermark: Incorpora informações de identificação no arquivo. Essa marca d'água é diretamente visível aos usuários.
   File watermark message	Sim	Insira a mensagem da marca d'água do arquivo.
   Data watermark message	Sim	Insira a mensagem da marca d'água dos dados.
   Embedded field	Não	Insira o campo no qual a marca d'água será incorporada. Nota Especifique um campo; caso contrário, o sistema seleciona um por padrão.
   Primary key / unique key	Não	Insira uma ou mais chaves primárias ou exclusivas, separadas por vírgulas (,). Nota Fornecer essas informações melhora significativamente a robustez da marca d'água dos dados.
   Attachments	Não	Faça upload de imagens ou documentos para fornecer informações adicionais sobre a exportação.

4. Após configurar os parâmetros, clique em Submit e aguarde a aprovação.

   O sistema executa uma pré-verificação de SQL.

5. Clique em Submit for Approval e aguarde a aprovação da solicitação.

   Visualize o progresso da aprovação na seção Approval da página de detalhes do ticket.

   Importante

   A exportação deve ser realizada em até 24 horas após a aprovação do ticket. Após esse período, o ticket expira; crie um novo. Para instâncias no modo Security Collaboration, é possível ajustar a janela de tempo para a exportação após a aprovação. Para isso, acesse as configurações de Security Rules > Data Export associadas à instância e modifique o parâmetro Period for Performing Export after Export Request of SQL Result Set Is Approved.

6. Na seção Execute/Automatic Execution, clique em Export.

7. Na caixa de diálogo Export Settings, configure as definições de exportação.

   Parâmetro	Descrição
   Format (Obrigatório)	O formato do arquivo para exportação. Os formatos compatíveis incluem CSV, EXCEL, SQL e JSON (para NoSQL). Nota Caso opte por incorporar uma marca d'água de arquivo, selecione EXCEL como formato de exportação. Se este parâmetro não aparecer, o parâmetro global Enable file watermark for SQL result set exports pode estar ativado. Acesse O&M > Configuration Management, desative este parâmetro e execute a exportação novamente.
   Character set (Obrigatório)	O conjunto de caracteres do conteúdo exportado. Os conjuntos compatíveis incluem Default Character Set, GBK, UTF-8 e ISO-8859-1.
   Execution strategy (Obrigatório)	A estratégia de execução: Execute immediately: O sistema inicia a exportação imediatamente. Schedule: O sistema inicia a exportação em um horário especificado. Útil para evitar horários de pico do negócio. Nota Após definir uma execução agendada, não é possível modificar seus parâmetros.
   Export mode (Obrigatório)	O modo de exportação: Speed Mode: A tarefa de exportação não pode ser interrompida. Ordinary Mode: A tarefa de exportação pode ser interrompida.
   Export time (Obrigatório)	O tempo limite da tarefa de exportação, em segundos. O valor pode variar de 0 a 2.147.483. Caso este parâmetro não seja configurado, o tempo limite de exportação no nível da instância será usado por padrão. Visualize o tempo limite de exportação no nível da instância consultando Registrar uma instância de banco de dados. Nota Se a duração da tarefa exceder o tempo especificado antes da conclusão da exportação, a tarefa falhará.
   Add field comment (Opcional)	Este parâmetro aparece apenas quando o tipo de banco de dados é MySQL e o formato de exportação é CSV. Ao ativar este parâmetro, o DMS adiciona uma linha com comentários de campo abaixo da linha de nome do campo nos resultados exportados.

   Nota

   O sistema realiza a exportação com base nas configurações especificadas. Visualize o progresso da exportação no console.

8. Após a conclusão da exportação, clique em Download Exported File.

   Importante

   Por padrão, após a conclusão da exportação, baixe o arquivo exportado a qualquer momento. Para instâncias no modo Security Collaboration, você pode definir um intervalo de tempo para o download do arquivo. Para isso, acesse as configurações de Security Rules > Data Export associadas à instância e configure o parâmetro Period for Downloading Exported File after Export Request of SQL Result Set Is Approved. Por exemplo, se o intervalo for definido como 1, baixe o arquivo em até 1 hora após a aprovação do ticket. Após 1 hora, o link de download expira.