Vous consultez la documentation de Looker 26.6. Cliquez sur ce lien pour consulter la documentation la plus récente.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Exporter des données depuis une instance Looker hébergée par le client

Les administrateurs d'instances Looker hébergées par le client peuvent envisager de migrer vers un environnement hébergé par Looker, principalement pour échanger la charge de l'administration de l'infrastructure contre une commodité accrue, une disponibilité améliorée des fonctionnalités et une fiabilité gérée. L'utilisation d'une instance hébergée par Looker réduit considérablement l'effort requis pour installer, configurer et gérer l'application Looker, car toutes les fonctions informatiques nécessaires liées à l'application Looker sont gérées pour vous.

La migration d'une instance hébergée par le client vers un environnement hébergé par Looker implique les principales étapes suivantes :

Collecte et configuration : vous ouvrez un ticket auprès de l'équipe Looker et remplissez le questionnaire de migration Looker On-Prem. L'équipe Looker crée une instance hébergée en fonction de vos réponses au questionnaire.
Chiffrement : les ingénieurs SRE Looker génèrent une paire de clés GnuPG (GPG) et partagent la clé publique avec vous.
Exporter : vous arrêtez votre instance Looker et exportez ses données (base de données, système de fichiers et clé gérée par le client (CMK)).
Transfert et importation des données : l'équipe Looker importe la sauvegarde dans l'instance hébergée par Looker et la vérifie.

Cette page explique comment effectuer les tâches requises pour l'étape 3 : Exporter :

Évaluer les performances et la taille du système de fichiers et de la base de données de votre instance
Sauvegardez, chiffrez et générez une somme de contrôle des données qui seront envoyées depuis le système de fichiers Looker.
Sauvegarder, chiffrer et générer une somme de contrôle des données qui seront envoyées à partir du schéma de base de données Looker
Créer, chiffrer et générer une somme de contrôle du fichier de clé CMK
Valider vos artefacts de sauvegarde
Transférer vos fichiers de sauvegarde pour la migration

Avant de commencer

Avant de pouvoir utiliser les scripts de cette page pour sauvegarder les données de votre instance, vous devez vous assurer que la configuration de votre instance Looker, de votre base de données et de votre chiffrement répond aux exigences de migration.

Configurations requises

Pour exécuter les scripts décrits sur cette page, vous devez disposer des versions suivantes de Looker et de la base de données :

Votre instance Looker doit exécuter une version Looker compatible.
Votre instance doit utiliser une base de données compatible avec MySQL version 8.0.0 ou ultérieure, afin que le fichier de schéma de base de données exporté puisse être utilisé par Looker.

Si vous utilisez AWS KMS, migrez vers le chiffrement AES-256 GCM de Looker en suivant la procédure décrite sur la page de documentation Modifier les clés de chiffrement de Looker.

Pour garantir le stockage correct des données et l'affichage des caractères, le classement de votre base de données doit être défini sur utf8mb4 (recommandé) ou utf8. L'utilisation d'autres classements peut entraîner une altération des données ou des erreurs lors de l'enregistrement de caractères spéciaux.

Évaluer votre instance pour la migration

Pour déterminer si votre instance Looker hébergée par le client peut être migrée vers une instance Looker (Original) hébergée par Looker, vous devez évaluer la taille et les performances de la base de données et du système de fichiers de votre instance. Cette évaluation permet également de déterminer si votre environnement source peut gérer l'extraction de données qui a lieu lors du processus de génération de la sauvegarde. Ces informations aident l'équipe Looker à allouer suffisamment de ressources à l'instance cible hébergée sur Looker.

Pour effectuer l'évaluation, vous devez cloner le dépôt GitHub qui contient le script Looker permettant d'évaluer l'utilisation du calcul et les performances du système de fichiers d'une instance Looker. Ce script s'appuie sur le SDK Looker Go et est disponible dans le dépôt Looker O2C Migration Evaluation sur GitHub.

Les sections suivantes décrivent les étapes à suivre pour exécuter le script qui évalue votre instance, y compris les tâches suivantes :

Clonez le dépôt contenant le script.
Générez des identifiants d'API.
Exécutez la commande pour vérifier l'utilisation du calcul.
Exécutez la commande pour vérifier les performances du système de fichiers.

Installer les outils d'évaluation

Installez les outils, langages et SDK suivants sur la machine sur laquelle vous allez sauvegarder les données de votre instance Looker :

Cloner le dépôt d'évaluation de la migration Looker O2C

Pour cloner le dépôt contenant le script d'évaluation, exécutez la commande suivante à partir du répertoire d'accueil de l'utilisateur qui exécutera l'analyse et la sauvegarde :

git clone https://github.com/looker-open-source/looker-o2c-migration-tool.git

Générer des identifiants d'API

Le script d'évaluation utilise le SDK Looker pour récupérer des données, agissant comme un client d'API qui envoie des requêtes sur le réseau à votre serveur Looker. L'administrateur qui exécute le script doit disposer d'un ID client API Looker et d'un code secret du client. Pour générer des identifiants d'API pour votre compte administrateur Looker, procédez comme suit :

Accédez à la page Utilisateurs dans le panneau Admin.
Sélectionnez Modifier pour votre compte.
Sur la page d'informations du compte, recherchez la section Clés API3 et sélectionnez Modifier les clés.
Sélectionnez Nouvelle clé API.
Looker affichera un ID client et un code secret du client. Copiez ces valeurs et enregistrez-les dans un emplacement sécurisé.

Générer des informations sur l'utilisation du calcul

Pour utiliser le script d'évaluation de la migration afin d'obtenir des informations sur l'utilisation du calcul de votre instance, exécutez la commande suivante sur une machine disposant d'une connexion réseau directe au point de terminaison de l'API de l'application Looker :

cd looker-o2c-migration-tool
go run main.go --client-id API_CLIENT_ID --client-secret API_CLIENT_SECRET --looker-instance-address LOOKER_INSTANCE_ADDRESS --output-csv-path OUTPUT_CSV_PATH --ssl=SSL

Remplacez les éléments suivants :

API_CLIENT_ID : ID client obtenu à l'étape précédente.
API_CLIENT_SECRET : code secret du client obtenu à l'étape précédente.
LOOKER_INSTANCE_ADDRESS : adresse de votre instance Looker, y compris le protocole.
OUTPUT_CSV_PATH : chemin d'accès au fichier CSV de sortie, par exemple /content/compute_usage_info.csv.
SSL : indique si la connexion entre votre machine et l'instance Looker doit utiliser un certificat SSL. Sa valeur est true par défaut.

Cette commande génère un fichier CSV contenant les détails d'utilisation de l'instance Looker.

Générer des informations sur les performances du système de fichiers

Ce script affiche la taille et le nombre de fichiers des différents répertoires liés aux modèles, ainsi qu'un test de vitesse d'écriture sur le disque. Il suppose que Looker est installé dans le répertoire personnel d'un utilisateur dont le nom d'utilisateur est looker, comme décrit sur la page de documentation Installer l'application Looker.

Pour utiliser le script d'évaluation de la migration afin d'obtenir des informations sur les performances du système de fichiers de votre instance, exécutez la commande suivante sur la machine sur laquelle votre instance Looker est hébergée :

cd looker-o2c-migration-tool
go run main.go --file-system-evaluation --output-csv-path OUTPUT_CSV_PATH

Remplacez les éléments suivants :

OUTPUT_CSV_PATH : chemin d'accès au fichier CSV de sortie, par exemple /content/fs_perf_info.csv

Cette commande génère un fichier CSV contenant les performances du système de fichiers de l'instance Looker.

Préparer votre instance pour la sauvegarde

Préparez-vous à sauvegarder les données de votre instance en installant les packages et les dépendances nécessaires à l'exécution des scripts décrits sur cette page. Vous pouvez également définir des variables d'environnement pour simplifier l'écriture de vos commandes.

Installer et vérifier les dépendances

Lorsque vous installez les dépendances requises pour sauvegarder les données de votre instance Looker, utilisez le gestionnaire de packages standard pour votre distribution Linux. Les versions suivantes correspondent aux packages fournis dans Debian 12 (Bookworm) et représentent la version minimale de chaque package requis.

Installez les packages suivants sur la machine sur laquelle vous allez sauvegarder les données de votre instance Looker :

bash 5.2.15
gpg 2.2.40 (GnuPG) : le processus de génération de sauvegarde utilise gpg pour chiffrer les sauvegardes de la base de données et du système de fichiers avant de les partager avec l'équipe Looker.
libgcrypt 1.10.2
Gpg-agent 2.2.40 (GnuPG)
GNU tar 1.34
gzip 1.12
md5sum 9.1 (GNU coreutils)
GNU grep 3.11 (avec prise en charge de PCRE2 10.42 2022-12-11 ou version ultérieure)
GNU sed 4.9
mariadb-client-core (doit se connecter à votre MySQL 8.X)

Par exemple, exécutez les commandes suivantes pour installer les packages nécessaires sur un système Linux basé sur Debian :

sudo apt-get update
sudo apt-get install -y \
    bash \
    gnupg \
    libgcrypt20 \
    gnupg-agent \
    tar \
    gzip \
    coreutils \
    grep \
    sed \
    mariadb-client-core

Définir les variables

Les commandes suivantes définissent certaines variables qui seront utilisées tout au long du processus de génération de la sauvegarde. Configurez-les sur n'importe quel terminal sur lequel vous prévoyez d'exécuter d'autres commandes.

Variable d'environnement : définir le chemin d'accès au répertoire de sauvegarde

La commande suivante définit le chemin d'accès au répertoire de sauvegarde dans lequel les fichiers seront créés. Exécutez ces commandes dans n'importe quel terminal où vous prévoyez d'effectuer les tâches de génération de sauvegarde spécifiques au répertoire :

BACKUP_DIRECTORY="DIRECTORY_PATH"
BACKUP_DIRECTORY="${BACKUP_DIRECTORY%/}"

Remplacez les éléments suivants :

DIRECTORY_PATH : chemin d'accès où les fichiers de sauvegarde seront créés. Assurez-vous que ce répertoire est suffisamment grand pour contenir la sauvegarde. N'incluez pas le / de début du chemin.

Variable d'environnement : définir le chemin source pour la sauvegarde du système de fichiers

La définition de la variable pour le chemin source de la sauvegarde du système de fichiers suppose que looker est le nom d'utilisateur de celui qui a installé l'application Looker et que l'installation a eu lieu dans le répertoire d'accueil de l'utilisateur, comme décrit sur la page de documentation Installation de l'application Looker. Vous devez modifier la variable si vous avez installé Looker dans un autre répertoire. Définissez cette variable dans le terminal où vous exécuterez la sauvegarde du système de fichiers Looker :

  LOOKER_USER="looker"
  ROOT_LOOKER_FS_DIRECTORY="$(getent passwd "$LOOKER_USER" | cut -d: -f 6)"

Variable d'environnement : définir une nouvelle instance Looker

Définissez des variables pour représenter le nom et l'ID unique de l'instance dans laquelle vous allez importer les données. L'équipe Looker vous fournit les valeurs de ces variables.

export luid='LOOKER_HOSTED_INSTANCE_ID'
export customer='LOOKER_HOSTED_INSTANCE_NAME'

Remplacez les éléments suivants :

LOOKER_HOSTED_INSTANCE_ID : identifiant unique de l'instance Looker vers laquelle vous allez migrer
LOOKER_HOSTED_INSTANCE_NAME : nom de la nouvelle instance Looker vers laquelle vous allez migrer.

Variable d'environnement : clé de chiffrement

La commande suivante installe une clé GPG publique sur votre instance. Configurez-la sur n'importe quel terminal sur lequel vous exécuterez les commandes de sauvegarde de votre instance (Looker vous fournira la valeur de cette variable) :

base64_encryption_key="BASE64_ENCRYPTION_KEY"

Remplacez les éléments suivants :

BASE64_ENCRYPTION_KEY : clé de chiffrement utilisée par le script de sauvegarde pour chiffrer vos sauvegardes. L'équipe Looker vous fournit la valeur de cette variable.

Générer une clé de chiffrement publique

La commande suivante installera une clé publique pgp sur votre instance. Les scripts de sauvegarde utilisent cette clé pour chiffrer votre sauvegarde. Configurez-le sur n'importe quel terminal sur lequel vous exécuterez les commandes pour sauvegarder votre instance.

echo -n "${base64_encryption_key}" | base64 -d | gpg --import

Sauvegarder les données de votre instance

Exécutez les commandes suivantes pour empaqueter de manière sécurisée les composants essentiels du système de fichiers et du schéma de base de données de votre instance afin qu'ils puissent être transférés et restaurés sur une nouvelle instance Looker (Original) hébergée par Looker. Le script effectue la sauvegarde à l'aide de md5sum pour vérifier et valider l'intégrité de la sauvegarde. Enfin, il chiffre la sauvegarde à l'aide de GnuPG avant d'exporter les résultats au format de fichier MD5.

Sauvegarder les données du système de fichiers de votre instance

Exécutez ces commandes à partir du répertoire dans lequel vous souhaitez exporter les données de sauvegarde et dans le même terminal que celui dans lequel vous avez défini vos variables d'environnement. Sélectionnez l'onglet correspondant au type d'instance hébergée par Looker vers laquelle vous prévoyez de migrer.

Looker (version initiale)

Exécutez cette commande pour vous assurer que tous les hooks Git côté serveur personnalisés utilisés pour la validation des données ou l'automatisation du workflow sont inclus dans la sauvegarde :

cd "${BACKUP_DIRECTORY}"

function findHookPath() {
rootPath=$1

find \
    ${rootPath}/models{-user-*,}/*/.git/config \
    -maxdepth 0 \
    -type f \
    -xtype f \
  | xargs -I {} grep hooksPath {} \
  | sort \
  | uniq \
  | sed -r -e 's/^.+hooksPath = //g' \
  | xargs -I {} dirname {} \
  | sort \
  | uniq \
  | sed -r -e "s#\.\.\/\.\.\/#${rootPath}/#g"

}

hooksPath=$(findHookPath "${ROOT_LOOKER_FS_DIRECTORY}" | sort | uniq | head -1)

Exécutez cette commande pour lister tous les répertoires nécessaires et les sauvegarder :

time find "${ROOT_LOOKER_FS_DIRECTORY}" \
  -maxdepth 1 \
  -type d \
  \( \
         -name marketplace \
      -o -name bare_models \
      -o -name deploy_keys \
      -o -name models \
      -o -name remote_dependencies \
      -o -name models-self-service \
      -o -name "models-user-*" \
      -o -wholename "${hooksPath}" \
  \) | tar \
  --gzip \
  --create \
  --file="${customer}_looker_fs_backup.tar.gz" \
  --files-from=-

Exécutez cette commande pour obtenir une "empreinte" de la sauvegarde avant le chiffrement :

time md5sum "${customer}_looker_fs_backup.tar.gz" > "${customer}_fs_backup.md5"

Exécutez cette commande pour chiffrer la sauvegarde :

time gpg --encrypt --yes \
  --output "${customer}_looker_fs_backup.tar.gz.enc" \
  --recipient "looker-devops+migration-${luid}@google.com" \
  "${customer}_looker_fs_backup.tar.gz"

Exécutez cette commande pour obtenir une autre "empreinte" après le chiffrement :

time md5sum "${customer}_looker_fs_backup.tar.gz.enc" >> "${customer}_fs_backup.md5"

La somme de contrôle aide Looker à vérifier l'intégrité de votre sauvegarde de données.

Looker (Google Cloud Core)

cd "${BACKUP_DIRECTORY}"

function findHookPath() {
rootPath=$1

find \
    ${rootPath}/models{-user-*,}/*/.git/config \
    -maxdepth 0 \
    -type f \
    -xtype f \
  | xargs -I {} grep hooksPath {} \
  | sort \
  | uniq \
  | sed -r -e 's/^.+hooksPath = //g' \
  | xargs -I {} dirname {} \
  | sort \
  | uniq \
  | sed -r -e "s#\.\.\/\.\.\/#${rootPath}/#g"

}

hooksPath=$(findHookPath "${ROOT_LOOKER_FS_DIRECTORY}" | sort | uniq | head -1)

Exécutez cette commande pour lister tous les répertoires nécessaires et les sauvegarder :

time find "${ROOT_LOOKER_FS_DIRECTORY}" \
  -maxdepth 1 \
  -type d \
  \( \
         -name marketplace \
      -o -name bare_models \
      -o -name deploy_keys \
      -o -name models \
      -o -name remote_dependencies \
      -o -name models-self-service \
      -o -name "models-user-looker" \
      -o -wholename "${hooksPath}" \
  \) | tar \
  --gzip \
  --create \
  --file="${customer}_looker_fs_backup.tar.gz" \
  --files-from=-

Exécutez cette commande pour obtenir une "empreinte" de la sauvegarde avant le chiffrement :

time md5sum "${customer}_looker_fs_backup.tar.gz" > "${customer}_fs_backup.md5"

Exécutez cette commande pour chiffrer la sauvegarde :

time gpg --encrypt --yes \
  --output "${customer}_looker_fs_backup.tar.gz.enc" \
  --recipient "looker-devops+migration-${luid}@google.com" \
  "${customer}_looker_fs_backup.tar.gz"

Exécutez cette commande pour obtenir une autre "empreinte" après le chiffrement :

time md5sum "${customer}_looker_fs_backup.tar.gz.enc" >> "${customer}_fs_backup.md5"

La somme de contrôle aide Looker à vérifier l'intégrité de votre sauvegarde de données.

Ce script génère les fichiers suivants pour la partie migration du système de fichiers :

${customer}_looker_fs_backup.tar.gz.enc : sauvegarde chiffrée et compressée du système de fichiers.
${customer}_fs_backup.md5 : fichier contenant les sommes de contrôle pour la validation.

Sauvegarder le schéma de base de données de votre instance

Ces commandes préparent votre environnement à la sauvegarde du schéma de base de données de votre instance Looker en créant un fichier de configuration temporaire qui permet aux outils de migration de se connecter à la base de données interne de votre instance Looker. Plutôt que de transmettre directement des données sensibles telles que des noms d'utilisateur et des noms d'hôte dans les commandes, ce script les écrit dans le fichier de configuration, que des outils tels que mysqldump et mysql peuvent lire.

Exécutez la commande suivante pour créer le fichier de configuration temporaire et définir différents paramètres :

export database_name="DATABASE_SCHEMA_NAME"
temporary_cnf_file="$(mktemp --tmpdir=. --suffix .cnf)"
echo "[client]
host=DATABASE_HOST
port=DATABASE_PORT
user=DATABASE_USER
password=PASSWORD

[mariadb-dump]
no-sandbox

[mysql]
no-auto-rehash

[mysqldump]
no-tablespaces
loose_set-gtid-purged=OFF
single-transaction
quick
max_allowed_packet=1G
ignore-table=${database_name}.LookerQ_LookerBQ_ACTIVEMQ_ACKS
ignore-table=${database_name}.LookerQ_LookerBQ_ACTIVEMQ_LOCK
ignore-table=${database_name}.LookerQ_LookerBQ_ACTIVEMQ_MSGS

[Server-specific settings - mostly for mysqld/mariadbd processes]
max_allowed_packet = 1024M
" > ${temporary_cnf_file}

Remplacez les éléments suivants :

DATABASE_HOST : DNS ou adresse IP de la base de données Looker.
DATABASE_PORT : port de la base de données.
DATABASE_USER : nom d'utilisateur de la base de données pour exécuter l'exportation.
PASSWORD : valeur en texte brut du mot de passe de l'utilisateur qui exécutera l'exportation. Looker ne vérifiera pas ce mot de passe. Toutefois, si vous préférez ne pas avoir à saisir le mot de passe en texte brut, vous pouvez laisser cette variable vide. Le système vous demandera alors votre mot de passe lorsque vous exécuterez des commandes de sauvegarde.
DATABASE_SCHEMA_NAME : nom de votre base de données ou de votre schéma.

Si votre base de données nécessite un certificat SSL pour la connexion, ajoutez les chemins d'accès suivants au fichier de configuration temporaire :

Définissez le chemin d'accès au fichier de l'autorité de certification (CA) :

ssl-ca=/etc/mysql/certs/ca.pem

Définissez le chemin d'accès au certificat client SSL :

ssl-cert=/etc/mysql/certs/client-cert.pem

Définissez le chemin d'accès à la clé privée SSL du client :

ssl-key=/etc/mysql/certs/client-key.pem

Pour les bases de données MySQL, exigez un certificat SSL et vérifiez le certificat du serveur :

loose-ssl-mode=VERIFY_CA

Pour les bases de données MariaDB, exigez un certificat SSL et validez le certificat du serveur :

loose-ssl-verify-server-cert=ON

Exécutez les commandes suivantes pour effectuer, chiffrer et vérifier la sauvegarde de votre schéma de base de données.

Accédez au répertoire dans lequel vous souhaitez stocker votre sauvegarde :

cd "${BACKUP_DIRECTORY}"

Exécutez cette commande pour sauvegarder votre base de données :

time mysqldump \
    --defaults-file="${temporary_cnf_file}" \
    "${database_name}" \
  | gzip > "${customer}_looker_db_backup.sql.gz"

Exécutez cette commande pour créer une "empreinte" de votre sauvegarde avant le chiffrement :

time md5sum "${customer}_looker_db_backup.sql.gz" >> "${customer}_db_backup.md5"

Exécutez cette commande pour chiffrer votre sauvegarde :

time gpg --encrypt --yes \
    --output "${customer}_looker_db_backup.sql.gz.enc" \
    --recipient "looker-devops+migration-${luid}@google.com" \
    "${customer}_looker_db_backup.sql.gz"

Exécutez cette commande pour obtenir une autre "empreinte" après le chiffrement :

time md5sum "${customer}_looker_db_backup.sql.gz.enc" >> "${customer}_db_backup.md5"

Ce script produit les fichiers suivants pour la partie du schéma de base de données de la migration :

${customer}_looker_db_backup.sql.gz.enc : sauvegarde chiffrée et compressée du schéma de base de données.
${customer}_db_backup.md5 : fichier contenant les sommes de contrôle pour la validation.

Chiffrer votre clé de chiffrement gérée par le client (CMK)

Les commandes suivantes valident, formatent et chiffrent la clé CMK. Sans ce chiffrement, une base de données migrée ne peut pas être déchiffrée dans le nouvel environnement Looker.

Attention : La prochaine commande CMK ne doit être exécutée qu'une seule fois sur la machine qui héberge votre base de données interne ou sur celle qui héberge l'instance Looker, mais pas sur les deux.

Commencez par définir une variable avec votre clé CMK actuelle, qui doit être au format Base64 :

CMK="CUSTOMER_CMK_KEY"

Remplacez les éléments suivants :

CUSTOMER_CMK_KEY : valeur de votre CMK.

Exécutez ensuite les commandes suivantes pour générer un fichier de clé CMK, générer la somme de contrôle de la clé CMK déchiffrée, chiffrer le fichier CMK et générer la somme de contrôle de la clé CMK chiffrée :

echo -n "${CMK}" > "${customer}_looker_cmk_key"

time md5sum "${customer}_looker_cmk_key" >> "${customer}_cmk_key.md5"

time gpg --encrypt --yes \
  --output "${customer}_looker_cmk_key.enc" \
  --recipient "looker-devops+migration-${luid}@google.com" \
  "${customer}_looker_cmk_key"

time md5sum "${customer}_looker_cmk_key.enc" >> "${customer}_cmk_key.md5"

Ce script génère les fichiers suivants pour la partie CMK de la migration :

${customer}_looker_cmk_key.enc : fichier CMK chiffré
${BACKUP_DIRECTORY}/${customer}_cmk_key.md5 : fichier contenant les sommes de contrôle pour la validation

Préparer vos fichiers de migration

Les scripts que vous avez exécutés jusqu'à présent ont produit les fichiers suivants :

compute_usage_info.csv : fichier CSV contenant des informations sur l'utilisation du calcul de votre instance
fs_perf_info.csv : fichier CSV contenant des informations sur les performances du système de fichiers de votre instance
${customer}_looker_fs_backup.tar.gz.enc : sauvegarde chiffrée et compressée du système de fichiers
${customer}_fs_backup.md5 : fichier contenant les sommes de contrôle pour la validation
${customer}_looker_db_backup.sql.gz.enc : sauvegarde chiffrée et compressée du schéma de base de données
${customer}_db_backup.md5 : fichier contenant les sommes de contrôle pour la validation
${customer}_cmk_key.md5 : fichier contenant les sommes de contrôle pour la validation
${customer}_looker_cmk_key.enc : fichier CMK chiffré

Pour combiner les fichiers MD5 en un seul fichier appelé ${customer}_backup.md5, exécutez la commande suivante dans votre répertoire de sauvegarde :

cat \
    "${customer}_db_backup.md5" \
    "${customer}_fs_backup.md5" \
    "${customer}_cmk_key.md5" \
  | sort | uniq \
  > "${customer}_backup.md5"

Valider vos artefacts de sauvegarde

Pour vous assurer que vos fichiers de sauvegarde sont complets, sécurisés et prêts à être migrés, utilisez l'outil Looker On-Prem Data Verifier. Cet outil effectue une validation complète, y compris la vérification des sommes de contrôle MD5, des clés de chiffrement GPG, de la structure de la base de données et de la validité de la CMK.

Installer l'outil de validation

Pour exécuter l'outil de validation, vous devez avoir installé Go et GnuPG sur votre machine.

Pour cloner le dépôt et compiler l'outil, exécutez les commandes suivantes :

git clone https://github.com/looker-open-source/customer-scripts.git
cd customer-scripts/onprem-data-verifier
go build -o onprem-verifier main.go

Exécuter l'outil de validation

L'outil fonctionne sur le répertoire contenant vos fichiers de sauvegarde. Avant d'exécuter l'outil, assurez-vous que tous les fichiers requis (quatre artefacts chiffrés et trois artefacts déchiffrés) se trouvent dans ${BACKUP_DIRECTORY}.

Exécutez la commande suivante pour valider vos artefacts :

./onprem-verifier \
  --backupDir "${BACKUP_DIRECTORY}" \
  --customerName "${customer}" \
  --luid "${luid}"

En cas de réussite, l'outil génère un fichier metadata.json. Vous devez inclure ce fichier lorsque vous transmettez vos artefacts de sauvegarde à l'équipe Looker.

Transférer vos fichiers

À la fin du processus de sauvegarde et de chiffrement, vous devriez disposer des fichiers suivants :

${customer}_looker_db_backup.sql.gz.enc
${customer}_looker_fs_backup.tar.gz.enc
${customer}_looker_cmk_key.enc
${customer}_backup.md5
metadata.json
compute_usage_info.csv
fs_perf_info.csv

Transmettez ces fichiers à votre équipe Looker pour qu'elle les importe dans une instance hébergée par Looker.

Exporter des données depuis une instance Looker hébergée par le client Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Avant de commencer

Configurations requises

Évaluer votre instance pour la migration

Installer les outils d'évaluation

Cloner le dépôt d'évaluation de la migration Looker O2C

Générer des identifiants d'API

Générer des informations sur l'utilisation du calcul

Générer des informations sur les performances du système de fichiers

Préparer votre instance pour la sauvegarde

Installer et vérifier les dépendances

Définir les variables

Variable d'environnement : définir le chemin d'accès au répertoire de sauvegarde

Variable d'environnement : définir le chemin source pour la sauvegarde du système de fichiers

Variable d'environnement : définir une nouvelle instance Looker

Variable d'environnement : clé de chiffrement

Générer une clé de chiffrement publique

Sauvegarder les données de votre instance

Sauvegarder les données du système de fichiers de votre instance

Looker (version initiale)

Looker (Google Cloud Core)

Sauvegarder le schéma de base de données de votre instance

Chiffrer votre clé de chiffrement gérée par le client (CMK)

Préparer vos fichiers de migration

Valider vos artefacts de sauvegarde

Installer l'outil de validation

Exécuter l'outil de validation

Transférer vos fichiers

Exporter des données depuis une instance Looker hébergée par le client