Data Management:Exporter des jeux de résultats SQL

Prérequis

• La base de données doit être de l'un des types suivants :

  Type de base de données

  • Base de données relationnelle :

    • MySQL : ApsaraDB RDS for MySQL, PolarDB for MySQL, MyBase for MySQL, PolarDB-X et bases de données MySQL provenant d'autres sources

    • SQL Server : ApsaraDB RDS for SQL Server, MyBase for SQL Server et bases de données SQL Server provenant d'autres sources

    • PostgreSQL : ApsaraDB RDS for PostgreSQL, PolarDB for PostgreSQL, MyBase for PostgreSQL et bases de données PostgreSQL provenant d'autres sources

    • MariaDB : ApsaraDB RDS for MariaDB et bases de données MariaDB provenant d'autres sources

    • OceanBase : OceanBase en mode MySQL, OceanBase en mode Oracle et OceanBase géré par l'utilisateur

    • PolarDB for PostgreSQL (compatible avec Oracle)

    • Oracle

    • Dameng

    • Db2

  • NoSQL : MongoDB, Lindorm, Cassandra

  • Entrepôt de données : AnalyticDB for MySQL, AnalyticDB for PostgreSQL, DLA, ClickHouse, MaxCompute et Hologres

• Vous avez enregistré l'instance de base de données cible dans DMS.

Notes d'utilisation

• Les limites d'exportation d'un jeu de résultats SQL, telles que le nombre de lignes exportables gratuitement et la taille maximale de table pour une seule exportation, varient selon le mode de contrôle.

• Pour exporter des données depuis une autre base de données au sein de la même instance, connectez-vous à cette base de données dans DMS avec un compte disposant de privilèges élevés afin d'éviter les erreurs d'autorisation.

• Pour une base de données logique, la taille maximale d'exportation est de 512 Mo. Les données dépassant cette limite sont tronquées.

Procédure

1. Connectez-vous à DMS 5.0.

2. Dans la barre de navigation supérieure, sélectionnez Database Development > Data Export > SQL Result Set Export.

   Remarque

   Pour les types de bases de données autres que NoSQL, vous pouvez également exécuter une instruction SQL dans la fenêtre de la console SQL, puis sélectionner Export File > Export more data depuis l'onglet des résultats pour créer un ticket d'exportation de données.

3. Configurez les paramètres du ticket d'exportation de données.

   Remarque

   L'exemple suivant utilise une instance ApsaraDB RDS for MySQL en mode de contrôle Security Collaboration. Les paramètres peuvent varier légèrement pour d'autres types de bases de données.

   Paramètre	Obligatoire	Description
   Database name	Oui	Sélectionnez la base de données cible. Remarque Vous devez disposer des autorisations requises pour exporter des données depuis la base de données. Pour plus d'informations, consultez View my permissions.
   Reason category	Oui	Sélectionnez une raison pour l'exportation des données. Ce choix facilite le suivi futur des tickets.
   Business background	Oui	Décrivez en détail la raison ou l'objectif de l'exportation des données afin de réduire les échanges.
   Affected rows	Oui	Pour estimer le nombre de lignes de données concernées par cette exportation, utilisez la commande count dans la console SQL. Remarque Lors de la phase de précontrôle, le système affiche le nombre réel de lignes concernées. Vérifiez si ce nombre correspond à vos attentes et identifiez toute anomalie afin de prévenir les incidents de sécurité des données.
   Skip validation	Non	Indique s'il faut ignorer le processus de validation. Si vous sélectionnez Skip Validation, vous devez également fournir une raison. Avertissement Si vous sélectionnez Skip Validation, DMS ne vérifie pas le nombre de lignes concernées. L'exportation d'un volume important de données peut présenter des risques pour votre activité. Agissez avec prudence.
   Stakeholders	Non	Les utilisateurs désignés comme parties prenantes peuvent consulter le ticket et collaborer dessus. Les utilisateurs non spécifiés (à l'exception des administrateurs et des DBA) ne peuvent pas consulter le ticket.
   Export SQL statement	Oui	Saisissez une instruction SQL exécutable directement, telle que SELECT * FROM testtable. DMS vérifie automatiquement la syntaxe lors de la soumission de la demande. Vous ne pouvez pas soumettre la demande si la syntaxe est incorrecte. Remarque Seules les instructions de requête SELECT sont prises en charge.
   Embed watermark	Oui	Indique s'il faut intégrer un filigrane dans le fichier exporté. Yes : Intègre un filigrane dans le fichier exporté. No : N'intègre pas de filigrane.
   Embedding method	Oui	Sélectionnez une méthode d'intégration : Data watermark : Intègre des informations d'identification dans les données. Ce filigrane n'est pas facilement perceptible par les utilisateurs des données. File watermark : Intègre des informations d'identification dans le fichier. Ce filigrane est directement visible par les utilisateurs des données.
   File watermark message	Oui	Saisissez le message du filigrane de fichier.
   Data watermark message	Oui	Saisissez le message du filigrane de données.
   Embedded field	Non	Saisissez le champ dans lequel le filigrane sera intégré. Remarque Si vous ne spécifiez pas de champ, le système en sélectionne un par défaut.
   Primary key / unique key	Non	Saisissez une ou plusieurs clés primaires ou uniques, séparées par des virgules (,). Remarque Fournir ces informations améliore considérablement la robustesse du filigrane de données.
   Attachments	Non	Téléchargez des images ou des documents pour fournir des informations supplémentaires sur l'exportation.

4. Une fois les paramètres configurés, cliquez sur Submit et attendez l'approbation.

   Le système effectue un précontrôle SQL.

5. Cliquez sur Submit for Approval et attendez que la demande soit approuvée.

   Consultez la progression de l'approbation dans la section Approval de la page des détails du ticket.

   Important

   Effectuez l'exportation dans les 24 heures suivant l'approbation du ticket. Passé ce délai, le ticket expire et vous devez en créer un nouveau. Pour une instance en mode Security Collaboration, vous pouvez ajuster la fenêtre temporelle permettant d'effectuer l'exportation après approbation. Pour ce faire, accédez aux paramètres Security Rules > Data Export associés à l'instance, et modifiez le paramètre Period for Performing Export after Export Request of SQL Result Set Is Approved.

6. Dans la section Execute/Automatic Execution, cliquez sur Export.

7. Dans la boîte de dialogue Export Settings, configurez les paramètres d'exportation.

   Paramètre	Description
   Format (Obligatoire)	Le format de fichier pour l'exportation. Les formats pris en charge incluent CSV, EXCEL, SQL et JSON (pour NoSQL). Remarque Si vous choisissez d'intégrer un filigrane de fichier, sélectionnez EXCEL comme format d'exportation. Si ce paramètre n'apparaît pas, cela peut être dû au fait que le paramètre global Enable file watermark for SQL result set exports est activé. Accédez à O&M > Configuration Management, désactivez ce paramètre, puis effectuez à nouveau l'opération d'exportation.
   Character set (Obligatoire)	Le jeu de caractères pour le contenu exporté. Les jeux de caractères pris en charge incluent Default Character Set, GBK, UTF-8 et ISO-8859-1.
   Execution strategy (Obligatoire)	La stratégie d'exécution : Execute immediately : Le système démarre l'exportation immédiatement. Schedule : Le système démarre l'exportation à une heure spécifiée. Cela est utile pour éviter les heures de pointe d'activité. Remarque Une fois qu'une exécution planifiée est définie, ses paramètres ne peuvent pas être modifiés.
   Export mode (Obligatoire)	Le mode d'exportation : Speed Mode : La tâche d'exportation ne peut pas être interrompue. Ordinary Mode : La tâche d'exportation peut être interrompue.
   Export time (Obligatoire)	La durée d'expiration de la tâche d'exportation, en secondes. La valeur peut aller de 0 à 2 147 483. Si vous ne configurez pas ce paramètre, le délai d'expiration d'exportation au niveau de l'instance est utilisé par défaut. Pour afficher le délai d'expiration d'exportation au niveau de l'instance, consultez Register a database instance. Remarque Si la durée de la tâche dépasse le temps spécifié avant que l'exportation ne soit terminée, la tâche échoue.
   Add field comment (Facultatif)	Ce paramètre n'apparaît que lorsque le type de base de données est MySQL et que le format d'exportation est CSV. Si vous activez ce paramètre, DMS ajoute une ligne avec les commentaires de champ sous la ligne des noms de champ dans les résultats exportés.

   Remarque

   Le système effectue l'exportation en fonction des configurations spécifiées. Vous pouvez consulter la progression de l'exportation dans la console.

8. Une fois l'exportation terminée, cliquez sur Download Exported File.

   Important

   Par défaut, une fois l'exportation terminée, vous pouvez télécharger le fichier exporté à tout moment. Pour une instance en mode Security Collaboration, vous pouvez définir un intervalle de temps pour le téléchargement du fichier. Pour ce faire, accédez aux paramètres Security Rules > Data Export associés à l'instance, et configurez le paramètre Period for Downloading Exported File after Export Request of SQL Result Set Is Approved. Par exemple, si vous définissez l'intervalle sur 1, vous pouvez télécharger le fichier dans l'heure suivant l'approbation du ticket. Passé ce délai d'une heure, le lien de téléchargement expire.