Importation de données à partir d’une base de données MariaDB externe vers une instance de base de données Amazon RDS for MariaDB - Amazon Relational Database Service

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Importation de données à partir d’une base de données MariaDB externe vers une instance de base de données Amazon RDS for MariaDB

Vous pouvez importer des données à partir d’une base de données MariaDB existante vers une instance de base de données RDS for MariaDB. Pour cela, vous devez copier la base de données avec mysqldump ou mariadb-dump et la transférer directement dans l’instance de base de données RDS for MariaDB. L’utilitaire de ligne de commande mysqldump ou mariadb-dump est généralement utilisé pour effectuer des sauvegardes et des transferts de données d’un serveur MariaDB vers un autre. Il est inclus dans les logiciels clients MariaDB.

À partir de MariaDB 11.0.1, vous devez utiliser mariadb-dump à la place de mysqldump.

Une commande mysqldump classique pour déplacer les données d’une base de données externe vers une instance de bases de données Amazon RDS ressemble à l’exemple suivant. Remplacez les valeurs par vos propres informations. Pour les versions 11.0.1 et ultérieures de MariaDB, remplacez mysqldump par mariadb-dump.

mysqldump -u local_user \
    --databases database_name \
    --single-transaction \
    --compress \
    --order-by-primary  \
    --routines=0 \
    --triggers=0 \
    --events=0 \
    -plocal_password | mariadb -u RDS_user \
        --port=port_number \
        --host=host_name \
        -pRDS_password
Important

Veillez à ne pas laisser d’espace entre l’option -p et le mot de passe saisi.

Une bonne pratique de sécurité consiste à spécifier des informations d’identification autres que les invites affichées dans cet exemple.

Assurez-vous que vous êtes conscient des recommandations et des considérations suivantes :

  • Excluez les schémas suivants du fichier de vidage :

    • sys

    • performance_schema

    • information_schema

    L’utilitaire mysqldump et mariadb-dump exclut ces schémas par défaut.

  • Si vous devez migrer des utilisateurs et des privilèges, pensez à utiliser un outil qui génère le langage de contrôle des données (DCL) pour les recréer, tel que l'pt-show-grantsutilitaire.

  • Pour effectuer l'importation, assurez-vous que l'utilisateur qui l'effectue a accès à l'instance de base de données. Pour de plus amples informations, veuillez consulter Contrôle d'accès par groupe de sécurité.

Les paramètres utilisés sont les suivants :

  • -u local_user – Utilisez ce paramètre pour spécifier un nom d’utilisateur. Lors de la première utilisation de ce paramètre, spécifiez le nom d’un compte utilisateur sur la base de données MariaDB locale que vous identifiez avec le paramètre --databases.

  • --databases database_name : utilisez ce paramètre pour spécifier le nom de la base de données sur l’instance MariaDB locale que vous souhaitez importer dans Amazon RDS.

  • --single-transaction – Utilisez ce paramètre pour vérifier que toutes les données chargées depuis la base de données locale sont en cohérence avec un point dans le temps unique. S’il existe d’autres processus qui modifient les données pendant que mysqldump ou mariadb-dump les lit, l’utilisation de ce paramètre permet de maintenir l’intégrité des données.

  • --compress – Utilisez ce paramètre pour réduire la consommation de bande passante réseau par compression des données à partir de la base de données locale avant de les envoyer vers Amazon RDS.

  • --order-by-primary – Utilisez ce paramètre pour réduire le temps de chargement en triant les données de chaque tableau sur par clé primaire.

  • --routines : utilisez ce paramètre si des routines telles que des procédures stockées ou des fonctions existent dans la base de données que vous copiez. Définissez le paramètre sur 0 pour exclure les routines pendant le processus d’importation. Ensuite, recréez manuellement les routines dans la base de données Amazon RDS.

  • --triggers : utilisez ce paramètre si des déclencheurs existent dans la base de données que vous copiez. Définissez le paramètre sur 0 pour exclure les déclencheurs pendant le processus d’importation. Ensuite, recréez manuellement les déclencheurs dans la base de données Amazon RDS.

  • --events : utilisez ce paramètre si des événements existent dans la base de données que vous copiez. Définissez le paramètre sur 0 pour exclure les événements pendant le processus d’importation. Ensuite, recréez manuellement les événements dans la base de données Amazon RDS.

  • -plocal_password – Utilisez ce paramètre pour spécifier un mot de passe. Lors de la première utilisation de ce paramètre, spécifiez le mot de passe du compte utilisateur identifié avec le premier paramètre -u.

  • -u RDS_user – Utilisez ce paramètre pour spécifier un nom d’utilisateur. Lors de la seconde utilisation de ce paramètre, spécifiez le nom d’un compte utilisateur sur la base de données par défaut pour l’instance de bases de données MariaDB que vous identifiez avec le paramètre --host.

  • --port port_number : utilisez ce paramètre pour spécifier le port pour votre instance de base de données MariaDB. Par défaut, il s’agit du port 3306, sauf si vous avez modifié la valeur lorsque vous avez créé l’instance de base de données.

  • --host host_name : utilisez ce paramètre pour spécifier le nom du système de nom de domaine (DNS) du point de terminaison de l’instance de base de données Amazon RDS, par exemple, myinstance.123456789012.us-east-1.rds.amazonaws.com. Vous pouvez trouver la valeur du point de terminaison dans les détails de l’instance de base de données dans la console Amazon RDS.

  • -pRDS_password – Utilisez ce paramètre pour spécifier un mot de passe. Lors de la seconde utilisation de ce paramètre, vous spécifiez le mot de passe du compte utilisateur identifié par le second paramètre -u.

Assurez-vous de créer manuellement les procédures stockées, déclencheurs, fonctions ou événements dans votre base de données Amazon RDS. Si vous avez l’un de ces objets dans la base de données que vous copiez, excluez-les lorsque lors de l’exécution de mysqldump ou mariadb-dump. Pour ce faire, incluez les paramètres suivants avec votre commande mysqldump ou mariadb-dump :

  • --routines=0

  • --triggers=0

  • --events=0

Exemple

L’exemple suivant copie l’exemple de base de données world de l’hôte local sur une instance de bases de données MariaDB. Remplacez les valeurs par vos propres informations.

Pour Linux, macOS ou Unix :

sudo mariadb-dump -u local_user \
    --databases world \
    --single-transaction \
    --compress \
    --order-by-primary  \
    --routines=0 \
    --triggers=0 \
    --events=0 \
    -plocal_password | mariadb -u rds_user \
        --port=3306 \
        --host=my_instance.123456789012.us-east-1.rds.amazonaws.com \
        -pRDS_password

Pour Windows :

Exécutez la commande suivante dans une invite de commandes ouverte en cliquant avec le bouton droit sur Invite de commandes dans le menu Programmes de Windows, puis en choisissant Exécuter en tant qu’administrateur. Remplacez les valeurs par vos propres informations. 

mariadb-dump -u local_user ^
    --databases world ^
    --single-transaction ^
    --compress ^
    --order-by-primary  ^
    --routines=0 ^
    --triggers=0 ^
    --events=0 ^
    -plocal_password | mariadb -u RDS_user ^
        --port=3306 ^
        --host=my_instance.123456789012.us-east-1.rds.amazonaws.com ^
        -pRDS_password
Note

Une bonne pratique de sécurité consiste à spécifier des informations d’identification autres que les invites affichées dans l’exemple.