SQWareProduction:oracle:bin:sqwora ExpdpAllPDB.ksh

Sommaire

1 Presentation
2 Aide en ligne
3 Traitement de l'erreur
- 3.1 Erreurs de parse des arguments
- 3.2 Execution errors
4 Exemples d'utilisation

Presentation

Script $gvsqw_OraBin/sqwora_ExpdpAllPDB.ksh :

Genere Oracle expdp pour toutes les PDB
Le script purge automatiquement les anciennes generations
Vous pouvez choisir:

differente police de retention
type de compression

- gzip
- bzip2
- compress
- none

different directory pour mettre le dump
different directory pour mettre le log
copie le fichier dump

Aide en ligne

L'aide en ligne est accessible dans la plupart des scripts avec l'option -h.
Ex: $gvsqw_OraBin/sqwora_ExpdpAllPDB.ksh -h
Contenu de l'aide :

Sourcing sqwora_Global.lib v2024.03 SQWareProduction for Oracle (dbSQWare) ... 

Utilisation: sqwora_ExpdpAllPDB.ksh [-h] -I <instance> [+ options]

DESCRIPTION
   sqwora_ExpdpAllPDB.ksh expdp script
SUPPORT
   Oracle versions supportees: 10gR2 <= v <= 21c

PARAMETERS
     -I  instance       : Instance cible pour expdp.
OPTIONS
     -h                 : Affichage de l'aide complete.
     -s                 : Affichage des exemples d'utilisation.
     -HI   nb_gen       : Nombre de generations a garder (par defaut: 1).
     -P    Nb threads   : Nombre de threads en parallele (par defaut 2).
     -IS   listpdb      : Liste des PDB pour execution de copy (par defaut toutes).
     -ES   listpdb      : Liste des PDB a exclure.
     -IL   likeclause   : Clause d'inclusion de type like pour generer la liste des PDB (exemple: 'pdb%').
     -EL   likeclause   : Clause d'exclusion PDB de type like (exemple: 'nopdb%').
     -AGR Nb_sec        : Nombre de secondes entre deux lancements (par defaut 1s).
     -AGE Nb_sec        : Nombre de secondes entre deux check de fin (par defaut 10s).
     -PS Nb threads     : Nombre de PDB en parallele (par defaut 2).
     -Pdb pdb_name      : pdb_name liste pour multitenant (par defaut toutes).
     -OPT option        : Option a ajouter sur la commande expdp.
     -ZIP extension     : Compressor extension gz,bz2,Z,none (par defaut: none).
     -FRT return_code   : Valeur forcee du code retour sur erreur.
     -AddMail   email   : Adresse Email a ajouter a 'pmexpdba@gmail.com'.
     -SendReport        : Envoi du rapport d'execution.
     -NoConsistent      : Supprime l'option 'flashback_time=systimestamp'.
     -RD      directory : Repertoire pour Expdp (par defaut /$(echo ${HOME}|cut -d/ -f2)/backup/${ORACLE_SID}/expdp).
     -PutInf  u@h:path  : user@host:path pour pousser le dump sur le host distant.
     -WCD  whereclause  : Clause where pour generer la liste des PDB.
     -NoMail            : Desactive l'envoi de mail sur erreur a pmexpdba@gmail.com (par defaut, envoi sur erreur).
     -Locale    locale  : Force la Locale d'affichage de l'aide (fr,en).
     -Exec              : Execute expdp (par defaut, affiche les commandes generees).

Information:
Pour etre sur d'avoir une aide a jour, reportez vous directement a l'aide en ligne du script avec l'option -h .

Traitement de l'erreur

Erreurs de parse des arguments

Ce type de message est genere:

Lack instance parameter, Utilisation: sqwora_ExpdpAllPDB.ksh [-h] -I <instance> [+ options]

Si vous vous connectez via un terminal, aucun mail ne sera envoyé et vous aurez plutôt ce type de message:

Not sending mail because you are in connected mode !!!
Lack instance parameter

Si vous n'êtes pas connecté à un terminal, le message d'erreur apparaît et est envoyé par mail à l'adresse contenue dans la variable $gvsqw_GlobalMail (Voir l'aide pour personnaliser cette variable). L'objet commence toujours par "$gvsqw_MailMsg_oracle : " (Voir l'aide pour personnaliser cette variable).

Information:
L'envoi de mail peut être désactivé par l'option -NoMail pour une exécution.

Execution errors

Que vous soyez ou non connecté à un terminal, le message d'erreur apparaît et un mail contenant un résumé des erreurs de traitement est envoyé à l'adresse contenue dans la variable $gvsqw_GlobalMail (Voir l'aide pour personnaliser cette variable). L'objet commence toujours par "$gvsqw_MailMsg_oracle : " (Voir l'aide pour personnaliser cette variable).

Information:
L'envoi de mail peut être désactivé par l'option -NoMail pour une exécution.

Exemples d'utilisation

Sourcing sqwora_Global.lib v2024.03 SQWareProduction for Oracle (dbSQWare) ... 

#Standard (Locale) help for script sqwora_ExpdpAllPDB.ksh:


$gvsqw_OraBin/sqwora_ExpdpAllPDB.ksh -h
#Affichage de l'aide en ligne pour ce script

$gvsqw_OraBin/sqwora_ExpdpAllPDB.ksh -Locale fr -h
#Affichage de l'aide en ligne pour ce script avec forcage de la locale 'fr' (Locale par defaut geree par $gvsqw_Locale)

$gvsqw_OraBin/sqwora_ExpdpAllPDB.ksh -s
#Affichage des exemples d'utilisation pour ce script

$gvsqw_OraBin/sqwora_ExpdpAllPDB.ksh -I $ORACLE_SID 
#Genere les commandes mais ne les execute pas !

$gvsqw_OraBin/sqwora_ExpdpAllPDB.ksh -I $ORACLE_SID -Exec
#Genere Oracle expdp pour toutes les PDB de l'instance $ORACLE_SID

$gvsqw_OraBin/sqwora_ExpdpAllPDB.ksh -I $ORACLE_SID -IS 'thisone,thatone' -Exec
#Liste des schemas a inclure pour la copie : thisone et thatone (par defaut all).

$gvsqw_OraBin/sqwora_ExpdpAllPDB.ksh -I $ORACLE_SID -ES 'thisotherone,thatotherone' -Exec
#Liste des schemas a exclure pour la copie : thisotherone et thatotherone

$gvsqw_OraBin/sqwora_ExpdpAllPDB.ksh -I $ORACLE_SID -IL '%_PROD' -Exec
#Clause like pour generee une liste dynamique de schemas a inclure (exemple: 'sch%').

$gvsqw_OraBin/sqwora_ExpdpAllPDB.ksh -I $ORACLE_SID -EL '%_TESTS' -Exec
#Clause like pour generee une liste dynamique de schemas a exclure (exemple: 'nosch%').

$gvsqw_OraBin/sqwora_ExpdpAllPDB.ksh -I $ORACLE_SID -WCD '<condition>' -Exec
#Clause where pour generee une liste dynamique de schemas a inclure (exemple: 'OPEN_MODE=MOUNTED')

$gvsqw_OraBin/sqwora_ExpdpAllPDB.ksh -I $ORACLE_SID -DIR <DirExport> -ZIP <ZipExtension> -Exec
#Genere un expdp pour toutes les PDB en utilisant le dossier d'export <DirExport> pour les donnees et les compresse au format specifie (gz,bz2,Z,none)

$gvsqw_OraBin/sqwora_ExpdpAllPDB.ksh -I $ORACLE_SID -PutInf <user@host:path> -Exec
#Exporte les schemas pour toutes les PDB et copie les fichiers dans le chemin <host:path>

$gvsqw_OraBin/sqwora_ExpdpAllPDB.ksh -I $ORACLE_SID -Pdb <pdb_name> -Exec
#Specifie le nom du PDB <pdb_name> pour les environnements multi-tenant

$gvsqw_OraBin/sqwora_ExpdpAllPDB.ksh -I $ORACLE_SID -HI <NbGeneration> -Exec
#Definie le nombre de version de donnees a converser pour ce job expdp

$gvsqw_OraBin/sqwora_ExpdpAllPDB.ksh -I $ORACLE_SID -AGR 20 -Exec
#Reglage du temps d'attente en secondes entre deux lancements de commandes, ici 20s (par defaut 10s)

$gvsqw_OraBin/sqwora_ExpdpAllPDB.ksh -I $ORACLE_SID -AGE 40 -Exec
#Reglage du temps d'attente en secondes entre deux check de fin, ici 40s (par defaut 30s)

$gvsqw_OraBin/sqwora_ExpdpAllPDB.ksh -I $ORACLE_SID -PS <NumericValue> -Exec
#Nombre de PDB a traiter en parallele, seulement avec Oracle Enterprise

$gvsqw_OraBin/sqwora_ExpdpAllPDB.ksh -I $ORACLE_SID -P <NumericValue> -Exec
#Execute le script sqwora_ExpdpAllPDB.ksh avec un degre de parallelisme de '<NumericValue>'
#Utilise par defaut la variable gvsqw_NbThreadXXX dans $gvsqw_OraBin/../etc/sqwora_GlobalVar.cfg
#Vous pouvez changer le defaut sur tout l'environnement si vous settez cette variable
#dans le fichier de configuration $gvsqw_OraBin/../etc_cust/sqwora_GlobalVar.cfg

$gvsqw_OraBin/sqwora_ExpdpAllPDB.ksh -I $ORACLE_SID -OPT '<options>' -Exec
#Ajoute l(es) option(s) <options> au traitement expdp pour toutes les PDB

$gvsqw_OraBin/sqwora_ExpdpAllPDB.ksh -I $ORACLE_SID -sysdba -Exec
#Force l'utilisateur a '/ as sysdba' au traitement expdp pour toutes les PDB

$gvsqw_OraBin/sqwora_ExpdpAllPDB.ksh -I $ORACLE_SID -NoConsistent -Exec
#Supprime l'option 'flashback_time=systimestamp' (definie par defaut)

$gvsqw_OraBin/sqwora_ExpdpAllPDB.ksh -I $ORACLE_SID -AddMail 'mymail1@mydomaine.com,mymail2@mydomaine.com' -Exec
#Ajoute la liste de mail a l'adresse par defaut geree par $gvsqw_GlobalMail

$gvsqw_OraBin/sqwora_ExpdpAllPDB.ksh -I $ORACLE_SID -SendReport -Exec
#Envoie la log par mail a la fin du traitement meme s'il n'y a pas d'erreur (par defaut, seulement en cas d'erreur)

$gvsqw_OraBin/sqwora_ExpdpAllPDB.ksh -I $ORACLE_SID -NoMail -Exec
#Desactive l'envoi de mail sur erreur a $gvsqw_GlobalMail (par defaut, seulement en cas d'erreur)

$gvsqw_OraBin/sqwora_ExpdpAllPDB.ksh -I $ORACLE_SID -FRT <NumericValue> -Exec
#Force le code retour a '<NumericValue>' sur erreur (si pas d'erreur, "exit 0"!)
#Vous pouvez aussi forcer le code retour de ce script pour tous
#si vous settez la variable d'environnement: $gvsqw_ForcedReturnCodeScript_sqwora_ExpdpAllPDB=<NumericValue>
#dans le fichier de configuration $gvsqw_OraBin/../etc_cust/sqwora_GlobalVar.cfg

Information:
Pour être sûr que les exemples sont exacts, reportez-vous directement à l'option d'aide en ligne du script -s .

SQWareProduction:oracle:bin:sqwora ExpdpAllPDB.ksh

Sommaire

Presentation

Aide en ligne

Traitement de l'erreur

Erreurs de parse des arguments

Execution errors

Exemples d'utilisation

Menu de navigation

Outils personnels

Espaces de noms

Variantes

Affichages

Plus

Rechercher

WikiFr

Général

SQWareProduction

Annexes

Outils