SAP HANA : hdbsql, sauvegarde et catalogue de sauvegarde en ligne de commande
Aide-mémoire hdbsql : connexion, ports, requêtes d'état, sauvegarde SYSTEMDB et tenants, scripts et nettoyage du catalogue.
Aide-mémoire pour administrer SAP HANA en ligne de commande avec hdbsql : connexion, requêtes d'état, sauvegarde des bases (SYSTEMDB et tenants), consultation et nettoyage du catalogue de sauvegarde.
Architecture
Un système HANA (identifié par son SID) contient une base système (SYSTEMDB) et une ou plusieurs bases tenant (architecture multi-tenant). Chaque base se connecte avec -d <nom_base>.
Connexion avec hdbsql
hdbsql se trouve dans le client HANA, par exemple /hana/shared/<SID>/hdbclient/scripts/hdbsql. Pour éviter de saisir le mot de passe en clair dans les scripts, enregistrer un alias dans le magasin sécurisé hdbuserstore :
hdbuserstore SET backup sqlserver01.example.com:30013 SYSTEM <PASSWORD>
hdbsql -U backup
Connexion directe, par numéro d'instance et par base :
hdbsql -i 00 -u SYSTEM -p '<PASSWORD>' -d SYSTEMDB
hdbsql -i 00 -u SYSTEM -p '<PASSWORD>' -d TENANT1
Options utiles : -i numéro d'instance, -u utilisateur, -p mot de passe, -d base, -n hôte, -U clé hdbuserstore, -x mode non verbeux.
Dans la session interactive, \s affiche l'état de la connexion (hôte, SID, base, utilisateur, versions, encodage), \q quitte. Pour un affichage plus lisible :
hdbsql TENANT1=> \mu
Multiline mode switched ON
hdbsql TENANT1=> \al
Aligned output mode switched ON
Ports
Le port SQL dépend du numéro d'instance (xx) :
| Port | Usage |
|---|---|
3xx15 |
Système mono-base (index server maître), conservé pour le tenant converti lors du passage en multi-tenant |
3xx13 |
Port SQL de SYSTEMDB |
3xx40, 3xx41, 3xx42 |
1er tenant : TrexNet, SQL, HTTP |
3xx43, 3xx44, 3xx45 |
2e tenant : TrexNet, SQL, HTTP |
Avec l'instance 00, SYSTEMDB répond donc sur le port 30013.
Requêtes d'état et d'inventaire
-- bases du système (à lancer sur SYSTEMDB)
SELECT * FROM "SYS"."M_DATABASES";
-- utilisateurs, schémas, tables
SELECT user_name FROM users;
SELECT * FROM schemas;
SELECT * FROM tables;
-- segments de log par service et par état
SELECT T2.HOST, T2.SERVICE_NAME, T1.STATE, COUNT(*)
FROM "M_LOG_SEGMENTS" T1 JOIN "M_SERVICES" T2 ON (T1.HOST = T2.HOST AND T1.PORT = T2.PORT)
GROUP BY T2.HOST, T2.SERVICE_NAME, T1.STATE;
Côté système : ps -ef | grep hdbindexserver vérifie que le processus tourne ; après su - <sid>adm, HDB info liste les processus.
Démarrage et arrêt
/usr/sap/<SID>/HDB<instance>/HDB start
/usr/sap/<SID>/HDB<instance>/HDB stop
Depuis SYSTEMDB, un tenant se démarre avec ALTER SYSTEM START DATABASE <nom_tenant>;.
Sauvegarde
Sauvegarde complète de SYSTEMDB vers un répertoire (le dernier élément du chemin sert de préfixe de nom de fichier) :
BACKUP DATA USING FILE ('/hana/backup/full_test/SYSTEMDB/');
BACKUP DATA USING FILE ('COMPLETE') COMMENT 'data backup of 2018-10-16';
BACKUP DATA FOR FULL SYSTEM USING FILE ('/hana/backup/full_test/SYSTEMDB/') COMMENT 'Backup of SYSTEMDB';
Une sauvegarde de tenant se lance de la même façon en se connectant avec -d <tenant>.
Script quotidien avec hdbuserstore
#!/bin/sh
source $HOME/.bashrc
date="$(date +"%Y-%m-%d")"
time="$(date +"%Y-%m-%d %H:%M:%S")"
backup="backup data using file ('$date')"
echo "daily backup :" $time "Start" >> $DIR_INSTANCE/backup.log
$DIR_EXECUTABLE/hdbsql -U backup -x $backup
time="$(date +"%Y-%m-%d %H:%M:%S")"
echo "daily backup :" $time "End" >> $DIR_INSTANCE/backup.log
Script sur plusieurs bases
#!/bin/bash
SERVER=localhost
INSTANCE=00
USER=SYSTEM
PASSWORD=<PASSWORD>
DATABASES='SYSTEMDB TENANT1 TENANT2'
for DB in $DATABASES; do
BACKUP_FILE="/hana/backup/data/DB_$DB/"
/hana/shared/<SID>/hdbclient/scripts/hdbsql -n $SERVER -i $INSTANCE -u $USER -p $PASSWORD -d $DB \
"BACKUP DATA USING FILE ('$BACKUP_FILE', 'FULL') COMMENT 'Backup of $DB';"
done
La liste des bases peut aussi être obtenue par SELECT DATABASE_NAME FROM SYS.M_DATABASES; exécutée sur SYSTEMDB. Préférer hdbuserstore à un mot de passe en clair dans le script.
Catalogue de sauvegarde
SELECT * FROM M_BACKUP_CATALOG;
SELECT entry_type_name, backup_id, state_name,
TO_VARCHAR(sys_start_time, 'YYYY/MM/DD') AS sys_start_time
FROM "SYS"."M_BACKUP_CATALOG";
Pour supprimer d'anciennes entrées à partir de leur identifiant :
BACKUP CATALOG DELETE BACKUP_ID 1680859685888;
Exporter le catalogue en JSON depuis la ligne de commande :
hdbsql -i 00 -u SYSTEM -p '<PASSWORD>' -d SYSTEMDB -A -xj 'select * from "SYS"."M_BACKUP_CATALOG";'
Remarques
- Les journaux et traces se trouvent sous
/hana/shared/<SID>/<hôte>/trace. - Les mots de passe, SID, hôtes et chemins de l'exemple sont génériques ; remplacer par les valeurs de l'environnement.