Options de ligne de commande

Utilisez cette option pour définir le nom de l'application client se connectant à Db2®. Le nom d'application client associé à une connexion Db2 est défini par défaut sur la valeur db2hpu. Cette valeur par défaut peut être remplacée pour une tâche donnée Optim High Performance Unload tâche en en définissant une autre via cette option de ligne de commande.

Attention: Le nom de l'application client peut également être défini dans le fichier de contrôle à l'aide de l'option CLIENT APPLICATION NAME . Si une valeur est définie à deux niveaux, celle spécifiée dans la ligne de commande est prise en compte.

Syntaxe: -a | --application application_name
Variables: application_name
Spécifiez un nom à utiliser comme nom de l'application cliente pour la connexion Db2 établie par Optim High Performance Unload.
Par défaut: db2hpu

Cette option permet de décharger des données numériques (de type entier ou réel) au format binaire. La représentation binaire utilisée sera toujours de type Big Endian, c'est-à-dire l'ordre des octets attendu par Db2 Load. Par défaut, Optim High Performance Unload n'utilise pas le format binaire pour les données numériques. Cette option ne peut être utilisée qu'en combinaison avec l'option --format avec le paramètre asc. Vous ne pouvez pas spécifier l'option de ligne de commande -- binary-numerics si vous utilisez un fichier de contrôle pour exécuter le déchargement.

Syntaxe: --binary-numerics
Variables: Néant.
Par défaut: Néant.

La valeur spécifiée pour cette option identifie le numéro de partition de base de données qui contient le catalogue dans une base de données multipartitionnée. Ce paramètre est pris en compte uniquement lors du déchargement à partir d'une image de sauvegarde. Vous ne pouvez effectuer un déchargement à partir d'une image de sauvegarde que si vous utilisez un fichier de contrôle. Par conséquent, l'option -c fonctionne uniquement avec l'option -f et uniquement si vous spécifiez la clause USING BACKUP CATALOG dans le bloc GLOBAL du fichier de contrôle.

Attention: Si vous spécifiez l'option CATN dans le fichier de contrôle, elle remplace l'option de ligne de commande -- catn .

Syntaxe: -c | --catn catalog_database_partition_number
Variables: catalog_database_partition_number
Par défaut: Si l'option CATN n'est pas définie dans le fichier de contrôle, la partition de base de données 0 est supposée.

Cette option permet de vérifier si toutes les Optim High Performance Unload versions installées sur les machines à prendre en compte pour une exécution donnée sont les mêmes. Afin de réaliser cette vérification, la tâche initiale Optim High Performance Unload tâche lancée rassemble la version du produit installée sur toutes les machines distantes indiquées par le fichier de contrôle, puis les compare à sa propre version.

Supposons que l'on ait un Optim High Performance Unload scénario d'utilisation impliquant 10 machines, avec la même version de Optim High Performance Unload installée sur toutes ces machines, et qu'il souhaite passer Optim High Performance Unload vers un niveau de code plus récent. Imaginons que, par erreur, cette mise à niveau ne soit effectuée que sur 9 de ces 10 machines. À ce stade, si Optim High Performance Unload est lancé pour exécuter ce scénario, le rapport d'exécution peut afficher des erreurs de démon car les différents Optim High Performance Unload niveaux de code impliqués ne seraient pas compatibles avec le protocole initiant les communications entre les Optim High Performance Unload tâches s'exécutant sur toutes les machines concernées. Ensuite, Optim High Performance Unload peut être lancé avec cette option de ligne de commande pour identifier une éventuelle divergence de version.

L'utilisation de cette option de ligne de commande ne peut fonctionner que si les Optim High Performance Unload versions installées sur toutes les machines à prendre en compte ont un niveau de code suffisamment élevé pour le comprendre. Dans le cas contraire, le comportement observé lors de son utilisation serait imprévisible.

Syntaxe: --check-consistency
Variables: Néant.
Par défaut: Néant.

Utilisez cette option pour spécifier des données d'identification au niveau utilisateur. Les données d'identification sont stockées dans le fichier de configuration db2hpu.creds. Pour plus d'informations, consultez la section Définition des informations d'identification utilisateur.

Vous pouvez spécifier l'un des types de données d'identification suivants :

remote: Indiquez cette valeur pour créer des données d'identification qui seront utilisées pour les tâches effectuées sur une base de données d'un noeud Db2 distant catalogué localement avec un client Db2 . Pour établir une connexion, un nom d'utilisateur et un mot de passe doivent être spécifiés dans le fichier de configuration db2hpu.creds.
locale: Indiquez cette valeur pour créer des données d'identification qui seront utilisées pour les tâches effectuées sur une base de données d'une instance Db2 locale. Utilisez cette option si vous souhaitez vous connecter à la base de données en utilisant les données d'identification d'un autre utilisateur. Pour établir une connexion, un nom d'utilisateur et un mot de passe doivent être spécifiés dans le fichier de configuration db2hpu.creds.
tsm: Indiquez cette valeur pour créer des données d'identification qui seront utilisées pour les tâches effectuées sur les images de sauvegarde créées par IBM® Tivoli® Storage Manager. Utilisez cette option si vous devez vous connecter à IBM Tivoli Storage Manager qui est configuré de telle sorte qu'une authentification explicite soit nécessaire. Pour établir une connexion, un nom d'utilisateur et un mot de passe doivent être spécifiés dans le fichier de configuration db2hpu.creds.
Fichier de clés: Spécifiez cette valeur pour créer des données d'identification qui seront utilisées pour les tâches concernant les bases de données ou les sauvegardes chiffrées, pour lesquelles une clé principale de chiffrement est nécessaire. Il peut être nécessaire de procéder ainsi si le magasin de clés associé est un fichier PKCS#12 local ou un magasin PKCS#11 sur matériel HSM.; Si l'environnement de chiffrement est basé sur un magasin PKCS#12 local, l'accès au fichier de ce magasin se déroule en interne, via un appel à l'outil IBM GSKit. L'accès au fichier de clés est protégé par un mot de passe. Ce mot de passe est stocké dans un fichier distinct associé au fichier de clés afin que les utilitaires qui accèdent au fichier de clés puissent tirer parti de ce mot de passe sans configuration supplémentaire. Autrement, ce mot de passe n'est pas stocké et les utilitaires devant accéder au fichier de clés nécessitent que le mot de passe leur soit transmis explicitement. Il est nécessaire de définir les identifiants du keystore pour Optim High Performance Unload lorsque le mot de passe du fichier keystore n'est pas caché.; Si l'environnement de chiffrement est basé sur un keystore (magasin de clés) d' PKCS#11 s sur un matériel HSM, il est nécessaire de définir des identifiants de keystore pour Optim High Performance Unload, même si le mot de passe protégeant l'accès au keystore est déjà stocké dans un fichier séparé.
cloudant: Spécifiez cette valeur pour créer des données d'identification qui seront utilisées pour les tâches de migration automatique effectuées sur une destination Cloudant. Pour établir une connexion, un mot de passe doit être spécifié dans le fichier de configuration db2hpu.creds. Pour plus d'informations, consultez les destinations « Configuration d' Optim High Performance Unload » pour le Big Data, « Db2 », « Object Storage » ou « PostgreSQL ».
couchdb: Spécifiez cette valeur pour créer des données d'identification qui seront utilisées pour les tâches de migration automatique effectuées sur une destination CouchDB. Pour établir une connexion, un mot de passe doit être spécifié dans le fichier de configuration db2hpu.creds. Pour plus d'informations, consultez les destinations Optim High Performance Unload configuration for Big Data, Db2, Object Storage ou PostgreSQL.
mongodb: Spécifiez cette valeur pour créer des données d'identification qui seront utilisées pour les tâches de migration automatique effectuées sur une destination MongoDB. Pour établir une connexion, un mot de passe doit être spécifié dans le fichier de configuration db2hpu.creds. Pour plus d'informations, consultez les destinations « Configuration d' Optim High Performance Unload » pour le Big Data, « Db2 », « Object Storage » ou « PostgreSQL ».
warehouse: Indiquez cette valeur pour créer des données d'identification qui seront utilisées pour les tâches de migration automatique effectuées sur une destination Db2 Warehouse ou pour les tâches de déchargement de données à partir d'une source Db2 Warehouse . Pour établir une connexion, un mot de passe doit être spécifié dans le fichier de configuration db2hpu.creds. Pour plus d'informations sur les tâches de migration automatique, consultez les destinations Optim High Performance Unload configuration for Big Data, Db2, Object Storage ou PostgreSQL.
swift: Spécifiez cette valeur pour créer les données d'identification qui seront utilisées pour les tâches de migration automatique effectuées sur une destination Swift. Pour établir une connexion, un mot de passe doit être spécifié dans le fichier de configuration db2hpu.creds. Pour plus d'informations, consultez les destinations Optim High Performance Unload configuration for Big Data, Db2, Object Storage ou PostgreSQL.
postgresql: Indiquez cette valeur pour créer des données d'identification qui seront utilisées pour les tâches de migration automatique effectuées sur une destination PostgreSQL. Pour établir une connexion, un mot de passe doit être spécifié dans le fichier de configuration db2hpu.creds. Pour plus d'informations, consultez les destinations Optim High Performance Unload configuration for Big Data, Db2, Object Storage ou PostgreSQL.
aws_s3: Spécifiez cette valeur pour créer des informations d'identification qui seront utilisées pour les tâches de migration automatique effectuées sur une destination compatible avec Amazon S3 ou S3, si la commande de téléchargement sous-jacente est basée sur l'outil cURL. Pour établir une connexion dans un tel cas, une clé secrète doit être spécifiée dans le fichier de configuration d' db2hpu.creds . Pour plus d'informations, consultez les destinations « Configuration d' Optim High Performance Unload » pour le Big Data, « Db2 », « Object Storage » ou « PostgreSQL ».
azure: Spécifiez cette valeur pour créer des informations d'identification qui seront utilisées pour les tâches de migration automatique effectuées sur une destination d' Azure, si la commande de téléchargement sous-jacente n'est pas basée sur l'outil d' cURL. Pour établir une connexion dans un tel cas, une clé de compte doit être spécifiée dans le fichier de configuration d' db2hpu.creds . Pour plus d'informations, consultez les destinations « Configuration d' Optim High Performance Unload » pour le Big Data, « Db2 », « Object Storage » ou « PostgreSQL ».
ibm_cos: Spécifiez cette valeur pour créer des informations d'identification qui seront utilisées pour les tâches de migration automatique effectuées sur une destination d' IBM Cloud Object Storage, si la commande de téléchargement sous-jacente est basée sur l'outil d' cURL. Pour établir une connexion dans un tel cas, une clé secrète doit être spécifiée dans le fichier de configuration d' db2hpu.creds . Pour plus d'informations, consultez les destinations Optim High Performance Unload configuration for Big Data, Db2, Object Storage ou PostgreSQL.

Syntaxe: --credentials remote | local | tsm | keystore | cloudant | couchdb | mongodb | warehouse | swift | postgresql | aws_s3 | azure | ibm_cos
Variables: Néant.
Par défaut: Néant.

Cette option permet d'indiquer la base de données contenant les tables à décharger. Optim High Performance Unload établit une connexion distincte à la base de données.

Syntaxe: -d | --database database_name | database_name:url:port[:ssl]
Variables: database_name; Indiquez un nom de base de données Db2 valide. La valeur par défaut est le nom de base de données spécifié dans le fichier db2hpu.cfg (voir page 23). Optim High Performance Unload convertit le nom en majuscules, sauf si vous l'entourez de guillemets doubles, par exemple «database_name ».; database_name:url:port[:ssl]; Indiquez un ensemble de trois ou quatre valeurs, séparées par des deux-points, correspondant respectivement au nom de la base de données Db2 Warehouse, à l'adresse URL du serveur associé, au numéro de port à utiliser pour la connexion à la base de données Db2 Warehouse, et, éventuellement, à la mention de l'utilisation ou non d'une connexion SSL. Si la connexion à utiliser est de type SSL, la valeur ‘yes’ doit être spécifiée. Sinon, la valeur ‘no’, qui est la valeur par défaut, doit être utilisée. Pour que la spécification de cette option puisse être interprétée comme prévu, il est indispensable de spécifier également l'option de ligne de commande --warehouse. Sinon, la spécification de la base de données est considérée dans son ensemble comme un seul nom de base de données Db2, ce qui, bien sûr, ne correspondrait pas à un nom valide.
Par défaut: db2dbdft dans le fichier db2hpu.cfg

Utilisez cette option pour vous connecter à une base de données Db2 distante à l'aide d' IBM Data Server Driver. Cet outil permet de se connecter à une base de données Db2 distante à partir d'une machine client sur laquelle elle est installée. Dans ce cas, il n'est même pas nécessaire d'installer un client Db2 sur cette machine pour décharger les données d'une base de données Db2 distante.

Syntaxe: --data-server-driver data_server_driver_path
Variables: data_server_driver_path; Indiquez le chemin racine dans lequel IBM Data Server Driver est installé.

Cette option de ligne de commande doit être transmise au chemin racine où IBM Data Server Driver est installé. Cette voie est utilisée par Optim High Performance Unload pour localiser la bibliothèque à prendre en compte pour la cartographie des API d' Db2 s nécessaires à son exécution.

L'utilisation d' IBM Data Server Driver ne peut être activée que si l'option de ligne de commande -r est également spécifiée pour un déchargement de données à partir d'une base de données Db2 distante. Dans ce cas, le nom d'environnement indiqué comme argument de l'option de ligne de commande -r doit être identique à celui de la base de données considérée.

Utilisez l'option --db2 pour indiquer si une commande donnée peut ou doit être traitée via Db2. Vous ne pouvez pas spécifier l'option de ligne de commande --db2 si vous utilisez un fichier de contrôle pour exécuter le déchargement.

NO indique que si la commande ne peut pas être traitée directement par Optim High Performance Unload (parce que la syntaxe de l'instruction SELECT est trop complexe ou non prise en charge), l'exécution du déchargement échouera.

YES indique que si l'instruction SELECT est trop complexe pour être traitée directement par le déchargement, l'instruction est transmise à Db2 pour extraire les lignes.

FORCE indique que Db2 sera utilisé pour extraire les lignes demandées. Si votre instruction SELECT contient des mots DBCS et que vous ne spécifiez pas DB2 YES, Optim High Performance Unload ne pourra pas traiter la table.

Syntaxe: --db2 yes | no | force
Variables: Néant.
Par défaut: Néant.

Attention: Si le paramètre de fichier db2hpu.cfg , db2, n'est pas défini, la valeur par défaut de cette option est YES. Dans le cas contraire, cette option de fichier de contrôle doit explicitement être définie de manière à modifier la valeur du paramètre db2 dans le fichier db2hpu.cfg.

Utilisez cette option pour exécuter l' Optim High Performance Unload exécutable qui a été compilé avec des options de débogage plutôt qu'avec des options d'optimisation. Cette option doit être utilisée uniquement sur instruction d' IBM.

L'option --debug entraîne l'exécution de Optim High Performance Unload s'exécute en mode débogage.

Selon la plate-forme, Optim High Performance Unload n'installe que les exécutables 32 bits, ou que les exécutables 64 bits. Dans tous les cas, il installe deux binaires : la version standard et la version de débogage. La version de débogage est à la fois compilée avec les options de débogage du compilateur activées et contient des Optim High Performance Unload appels de trace.

Indiquez --debug pour que le processus de débogage commence. Reportez-vous à l'option -- traces de cette section pour plus d'informations sur l'exécution d'une trace sans utiliser l'option --debug.

Attention: -- traces peut être utilisé avec ou sans --debug et contrôle si une trace est prise ou non. L'exécutable peut générer des traces, mais la trace est plus étendue si l'option --debug est également spécifiée. Le Optim High Performance Unload module de débogage fonctionnera correctement avec l'option --debug sans l'option --traces, mais Optim High Performance Unload ne produira aucune sortie de trace.

Syntaxe: --debug
Variables: Néant.
Par défaut: Néant.

Cette option permet de choisir le format de sortie du fichier à générer. Vous ne pouvez pas spécifier l'option de ligne de commande -- format si vous utilisez un fichier de contrôle pour exécuter le déchargement.

Syntaxe: --format asc|del|delimited|dsntiaul|ixf|json|orc|parquet|xml
Variables: Néant.
Par défaut: del

Astuce: Pour une description détaillée de chaque format de sortie, reportez-vous à la description de l'option de fichier de contrôle FORMAT .

Utilisez cette option pour spécifier le nom du fichier de contrôle que vous souhaitez Optim High Performance Unload utiliser.

Si un fichier de contrôle est utilisé, l'une de ces options en entrée est requise.

Syntaxe: -f | --file { [control_file_name|stdin] }
Variables: [control_file_name|stdin]
Indiquez un nom de fichier et un chemin d'accès valides pour le système d'exploitation sur lequel Db2 s'exécute. Spécifiez le mot -clé stdin si vous souhaitez Optim High Performance Unload lire les informations de contrôle à partir de l'entrée standard.
Important: Pour tester la syntaxe dans votre fichier de contrôle avant de décharger des données, utilisez l'option -- noexecute avec l'option -- file .
Par défaut: Néant.

Utilisez cette option pour afficher l' Optim High Performance Unload l'aide.

Syntaxe: -h | --help
Variables: Néant.
Par défaut: Néant.

Utilisez cette option pour spécifier l'instance Db2 pour la base de données qui contient les tables que vous souhaitez décharger. Optim High Performance Unload établit une connexion distincte à la base de données.

Syntaxe: -i | --instance instance_name
Variables: instance_name
Indiquez un nom d'instance Db2 valide. La valeur par défaut est le nom d'instance spécifié dans le fichier db2hpu.cfg.
Par défaut: Paramètre db2instance défini dans le fichier db2hpu.cfg, le cas échéant. Si l' db2instance n'est pas définie, Optim High Performance Unload prend la valeur de la DB2INSTANCE variable d'environnement. Sinon, un message d'erreur est généré et le déchargement échoue.

Cette option permet de spécifier que les données d'identification doivent être importées à partir du fichier transmis dans le fichier de configuration db2hpu.creds. Le fichier transmis doit être un fichier contenant des données d'identification valides préalablement créées via l'utilisation de l'option --to-file.

Le nom de fichier transmis à l'option --import-credentials peut avoir un chemin absolu ou relatif, et il doit correspondre à un fichier existant. Son contenu est contrôlé afin de s'assurer qu'il comporte des données d'identification valides.

Il peut contenir plusieurs données d'identification. S'il contient des données d'identification valides, elles sont importées dans le fichier de configuration db2hpu.creds.

Les règles suivantes sont appliquées lors de l'importation des données d'identification trouvées dans le fichier :

Si les données d'identification n'existent pas dans le fichier de configuration db2hpu.creds, elles sont ajoutées en tant que nouvelles données d'identification.
Si les données d'identification existent déjà dans le fichier de configuration db2hpu.creds, elles sont mises à jour.

L'avantage de la procédure d'importation des données d'identification est qu'il s'agit d'une procédure automatique sans invite interactive. Elle permet d'automatiser la création des données d'identification à partir d'un fichier préparé à cet effet.

Syntaxe: --import-credentials nom de fichier
Variables: nom_fichier
Par défaut: Néant.

Utilisez cette option pour arrêter le processus en cours d'exécution sur les systèmes UNIX™ et de manière propre et sécurisée Optim High Performance Unload sur les systèmes UNIX™ et Linux™ de manière propre et sécurisée.

Restriction : Cette option n'est pas disponible sur les systèmes Windows™.

Syntaxe: -k | --kill process_ID
Variables: process_ID
Spécifiez un identifiant valide du processus de la Optim High Performance Unload tâche que vous souhaitez arrêter.

Important: Vérifiez que vous disposez des droits appropriés pour arrêter le processus spécifié.
Par défaut: Néant.

Utilisez cette option pour activer le mode de liste des sauvegardes au démarrage Optim High Performance Unload.

Si le mode d'affichage d'une liste de sauvegardes est activé, seules les sauvegardes concernées sont affichées. Si ces sauvegardes se trouvent sur le disque, l'emplacement de leurs répertoires sont affichés eux aussi. Après ce rapport, Optim High Performance Unload se terminera normalement et il n'y aura pas de déchargement de données pour cette exécution.

Syntaxe: --list-backups
Variables: Néant.
Par défaut: Néant.

L'option --list-backups doit être utilisée pour une exécution basée sur l'utilisation d'un fichier de contrôle. Lorsque l'option --list-backups est utilisée avec un fichier de contrôle contenant une clause USING BACKUP, cette clause ne doit pas induire de sauvegarde intégrale. Il n'est pas possible d'utiliser l'option --list-backups s'il n'existe pas de clause USING BACKUP DATABASE dans chaque bloc UNLOAD du fichier de contrôle. Une clause USING COPY ne peut pas être utilisée dans un bloc UNLOAD si l'option --list-backups est spécifiée. Pour plus d'informations sur cette option, consultez la section suivante : Sauvegardes de listes

Utilisez cette option pour exécuter uniquement le traitement de la Optim High Performance Unload lié à la pièce de chargement de l' Db2.

Pour un déchargement standard, cette option limite le traitement à la génération d'une commande DB2 Load.

Pour une migration automatique, seule l'exécution de DB2 Load est effectuée.

Syntaxe: --load-only
Variables: Néant.
Par défaut: Néant.

Pour plus d'informations sur cette option, consultez la section suivante : Limiter le traitement de l' Optim High Performance Unload à la partie chargement de l' Db2.

Pour spécifier que Optim High Performance Unload peut utiliser autant de mémoire que nécessaire pour accomplir une tâche donnée, définissez memory_limit sur no. Vous ne pouvez définir memory_limit que si vous avez déjà défini le paramètre de fichier de configuration allow_unlimited_memory sur yes.

Syntaxe: --memory-limit yes | no
Variables: Néant.
Par défaut: Oui

Cette option permet de spécifier la destination où sont consignés les messages d'information, d'avertissement et d'erreur.

Syntaxe

-m | --message message_file

Variables

message_file

Spécifiez un nom de fichier valide pour le système d'exploitation sur lequel Optim High Performance Unload est exécuté. Si vous ne spécifiez pas de nom de fichier, les messages sont écrits sur la sortie d'erreur standard (stderr).

Si vous spécifiez le nom d'un fichier existant, Optim High Performance Unload ajoute les informations du nouveau message à la fin du fichier. Le programme n'écrase pas les données déjà existantes.

Par défaut

stderr

Utilisez cette option pour surveiller la progression d'une exécution spécifique en cours Optim High Performance Unload exécution, en lui spécifiant l'ID de processus de la tâche à surveiller. Cet identifiant de processus peut être déterminé à partir du rapport d'exécution de la tâche à surveiller, car il est affiché lors du lancement de cette tâche, grâce à un message d'information.

Syntaxe: --monitor pid
Variables: ID de processus
Par défaut: Néant.

Cette option permet de définir la syntaxe du script de fichier de contrôle. L'option --noexecute envoie la sortie au fichier de messages ou à l'erreur standard (stderr) au lieu de la sortie standard (stdout). Si vous ne spécifiez pas cette option, le comportement par défaut consiste à exécuter le script du fichier de contrôle.

Remarque: Il n'existe pas d'option de fichier de contrôle équivalente à l'option de ligne de commande -- noexecute .

Syntaxe: -n | --noexecute
Variables: Néant.
Par défaut: Néant.

Cette option permet de spécifier le nom complet du fichier de sortie, y compris le chemin d'accès.

Optim High Performance Unload décharge toutes les données dans le fichier spécifié. Par défaut, si cette option n'est pas définie et que le fichier de contrôle ne contient pas de clause OUTFILE, toutes les lignes sont envoyées à la sortie standard (stdout).

Remarque: Si vous utilisez l'option de fichier de contrôle -- file, toute clause de sortie de ce fichier de contrôle remplace ce qui est spécifié avec cette option.

Syntaxe: -o | --output output_file_name
Variables: output_file_name
Par défaut: Sortie standard (stdout)

Cette option permet de décharger des données au format décimal condensé. Cette option ne peut être utilisée qu'en combinaison avec l'option --format avec le paramètre asc. Lors d'un déchargement de données au format ASC, si cette option n'est pas indiquée, les données décimales sont déchargées au format étendu. Vous ne pouvez pas spécifier l'option de ligne de commande --packed-decimal si vous utilisez un fichier de contrôle pour exécuter le déchargement.

Syntaxe: --packed-decimal
Variables: Néant.
Par défaut: Néant.

Utilisez cette option pour indiquer les partitions de base de données qui font partie du déchargement pour un environnement de base de données partitionné. Elle est ignorée dans un environnement à partition unique. Dans les informations ci-dessous, n1 et n2 représentent les numéros de partition de base de données.

Condition requise: Pour les instances Db2 non partitionnées, si le numéro de partition de base de données est spécifié, vous devez utiliser PART (ALL) ou PART (0).

Syntaxe

--partition all | current | n1[{-|,} n2...]

Variables

all | current | n1[{-|,} n2...]

Utilisez la valeur par défaut all pour indiquer que les données de la table source doivent être déchargées de tous les noeuds définis pour la table source (la table source est celle indiquée à partir de la ligne de commande ou dans le fichier de contrôle).

Entrez current pour indiquer que les données de la table source seront déchargées de toutes les partitions de la base de données sur la machine où Optim High Performance Unload est démarré.

Spécifiez la valeur n1[{-|,} n2...] pour limiter le déchargement des données de la table source à une liste de noeuds. Cette option de ligne de commande écrase les noeuds répertoriés dans le fichier de contrôle. Les noeuds doivent respecter les conditions suivantes :

Les partitions de base de données doivent être définies dans le fichier db2nodes.cfg.
Les partitions de base de données doivent respecter la syntaxe du numéro de noeud Db2 .
Les partitions de base de données ne doivent être spécifiées qu'une seule fois.
Les partitions de base de données doivent se trouver dans le groupe de noeud de la table source.

Par défaut

all

Utilisez cette option lorsque vous souhaitez exécuter Optim High Performance Unload pour décharger des données d'une instance d' Db2, soit cataloguées localement sur un client Db2, soit par l'utilisation du pilote de serveur de données IBM. Étant donné que Optim High Performance Unload n'est pas installé sur les serveurs de données distants, Optim High Performance Unload ne traitera à distance qu'avec l'option FORCE d' DB2, même si elle n'est pas explicitement spécifiée. Si DB2 est défini sur YES ou NO, une erreur est renvoyée.

Attention: Si le gestionnaire de base de données de l'instance Db2 distante est configuré pour les authentifications au niveau du serveur, vous devez créer des données d'identification utilisateur avec l'option de ligne de commande -- credentials .

Syntaxe: -r | --remote name
Variables: Indiquez le nom du noeud distant qui est catalogué localement si vous utilisez un client Db2 ou indiquez le nom de la source de données si vous utilisez IBM Data Server Driver.
Par défaut: Néant.

Utilisez cette option lorsque vous souhaitez émettre une demande de sélection sans avoir à l'intégrer dans une demande complète Optim High Performance Unload. Cette option n'est pas compatible avec l'option --table ; toutefois, elle peut être utilisée avec l'option --file si le fichier de contrôle spécifié ne contient qu'une demande de sélection.

Syntaxe

--select

Par défaut

Néant.

Exemples

L'exemple suivant utilise un fichier de contrôle distinct file.ctl qui contient une demande de sélection telle que 'select * from employee'. La commande exécute la demande de sélection et envoie le résultat au fichier file.out :

db2hpu -f file.ctl -i db2inst1 -d sample -o file.out --select

L'exemple suivant utilise une demande de sélection d'entrée standard (stdin). La commande sélectionne toutes les entrées de la table d'employés de la base de données exemple, puis envoie le résultat de sortie au fichier file.out :

echo 'select * from employee' | db2hpu -f -i db2inst -d sample -o file.out --select

Cette option peut être utilisée lors de l'extraction de données depuis une sauvegarde effectuée à partir d'un autre système. Vous pouvez également l'utiliser pour repartitionner des données extraites d'une sauvegarde en mode autonome. Cette option indique Optim High Performance Unload de ne pas rechercher les fichiers et répertoires de l'instance d' Db2 sur ce système. Cette option modifie la signification de l'option -i. Lorsque -s est spécifié, -i doit être spécifié avec l'ID de propriétaire d'instance Db2 de l'instance qui a pris la sauvegarde.

Le paramètre facultatif vous permet de décharger des données à partir d'une image de sauvegarde compressée Db2 V9 en mode autonome. Le paramètre permet Optim High Performance Unload de trouver la bibliothèque de compression Db2, qui est nécessaire pour traiter un déchargement à partir d'une image de sauvegarde compressée Db2 V9.

Syntaxe: -s | --standalone db2_installation_path
Variables: Indiquez le chemin d'installation de Db2 .
Par défaut: Néant.

Cette option permet de spécifier le nom de la table contenant les données à décharger. L'une des options suivantes est requise : -f, -t, ou -v. La ligne de commande permet de spécifier une seule table. Si un fichier de contrôle contient des instructions de déchargement, indiquez le nom de table figurant dans le fichier de contrôle. Vous pouvez utiliser cette option pour décharger les tableaux récapitulatifs Db2 ™.

Si le nom de table est en lettres minuscules, vous ne pouvez pas indiquer db2hpu -t "table" car les guillemets (") sont considérés comme des caractères spéciaux par l'interpréteur de commandes. Dans ce cas, vous devez entrer la commande :

db2hpu -t \"table\"

La barre oblique inversée annule la signification spéciale des guillemets, et le nom de table est accepté en lettres minuscules.

Syntaxe: -t | --table [[SYSTEM.]owner.] table_name
Variables: owner and table_name
Si vous n'êtes pas le propriétaire de la table Db2 , spécifiez une valeur pour owner, suivie du nom de la table à décharger. Optim High Performance Unload convertit le nom en majuscules, sauf s'il est placé entre guillemets, par exemple : "table_name".
Par défaut: Néant.

Utilisez cette option pour spécifier un locataire à prendre en compte pour une tâche donnée de déchargement de données à partir d'une base de données locale.

La valeur qui peut lui être spécifiée doit être un identifiant d' Db2, correspondant à un nom de tenant existant. Sa valeur par défaut est « system », ce qui correspond au tenant appelé SYSTEM qui est également celui par défaut pour Db2. Lorsque cette option est spécifiée, la tâche exécutée ne peut traiter que les tables faisant partie du tenant spécifié. Si un locataire est spécifié dans le fichier de contrôle avec la clause TENANT, il est remplacé par le locataire spécifié dans la ligne de commande. Cette option ne peut être utilisée que si l'environnement d' Db2 s est au moins un environnement d' V12.1 s, et elle ne peut pas être spécifiée en même temps dans la ligne de commande avec les options d' --remote s ou d' --warehouse s.

Syntaxe: --tenant nom_locataire
Variables: TENANT_NAME
Spécifier un identifiant d' Db2, correspondant à un nom de tenant existant.
Par défaut: système

Cette option permet de spécifier que les données d'identification doivent être créées dans le fichier transmis et non dans le fichier de configuration db2hpu.creds.

Le nom de fichier transmis à l'option --to-file peut avoir un chemin absolu ou relatif. Si le fichier existe déjà, son contenu est contrôlé afin de s'assurer qu'il contient des données d'identification valides, puis les nouvelles données d'identification y sont ajoutées. Si le fichier n'existe pas, il est créé avec les nouvelles données d'identification. L'option --to-file ne peut pas être spécifiée sans l'option --credentials.

Syntaxe: --to-file nom de fichier
Variables: nom_fichier
Par défaut: Néant.

Utilisez cette option lorsque IBM vous demande d'activer une Optim High Performance Unload trace de maintenance. Cette option doit être utilisée uniquement sur instruction d' IBM.

Lorsque vous lancez une recherche, Optim High Performance Unload stocke les fichiers de trace dans le répertoire à partir duquel vous avez lancé la commande db2hpu et fournit un fichier pour chaque mot-clé traité. Les noms de fichier sont au format MOTCLE_nnnnn, où MOTCLE représente un mot clé de trace et nnnnn, l'ID processus du déchargement effectué. Par exemple :

$ARGS_456789

Vous serez invité à compresser les fichiers et à les envoyer au service de support logiciel IBM .

Des fichiers de trace sont créés pour tous les mots clés de trace qui s'appliquent. Les mots-clés sont contenus dans le fichier db2hpu.trace que Optim High Performance Unload crée lors de l'installation. La trace est exécutée à l'aide du fichier db2hpum, qui est un fichier exécutable de déchargement compilé en mode optimisé.

L'option de trace peut également être utilisée avec l'option --debug. Si l'option -traces est utilisée avec l'option --debug, les mots clés utilisés seront ceux spécifiés dans le fichier db2hpu.debug. Ce fichier contient plus de mots clés de trace. De plus, lorsque l'option --debug est spécifiée, la trace s'exécute à l'aide du fichier db2hpum_debug, un fichier exécutable de déchargement compilé en mode débogage.

Syntaxe: --traces
Variables: Néant.
Par défaut: Néant.

Utilisez l'option --umask pour remplacer les droits d'accès au système cible lorsque vous effectuez une migration automatique des données. Par défaut, la valeur umask pour les déchargements distants est celle du démarreur de démon xinetd (ou inetd). Les autorisations des fichiers générés sont alors restreintes par la valeur umask racine. Lorsque vous effectuez une migration automatique des données, cette restriction peut être problématique car Db2 Load a besoin que les fichiers de données soient lisibles par l'utilisateur de l'instance de la base de données cible. Parfois (selon la configuration système) l'umask appliqué est trop restrictif et les fichiers générés ne sont pas visibles par l'utilisateur de l'instance de la base de données cible. La Optim High Performance Unload fonctionnalité umask vous permet de passer outre cet umask restrictif et de générer des fichiers avec les permissions appropriées.

La définition de la fonction umask est basée sur la définition umask UNIX. Trois chiffres en notation octale sont utilisés pour définir les droits d'accès des utilisateurs, des groupes et des autres masques. La valeur umask peut utiliser les valeurs octales comprises entre 000 et 777. La valeur umask recommandée pour Optim High Performance Unload est de 022. Les fichiers de sortie sont générés avec les droits adéquats pour une migration automatique ou manuelle.

Restriction :

Le paramètre umask s'applique uniquement aux fichiers générés à distance.
La définition de umask dans Optim High Performance Unload ne vous permet pas de générer des fichiers de données avec tous les types de droits d'accès. Optim High Performance Unload interrogera toujours la génération des fichiers de données avec des droits d'accès 644 (rw-r--r--). Si le umask est plus restrictif, les droits d'accès seront réduits. Si l'option umask est moins restrictive, les droits d'accès resteront rw-r--r--.

Syntaxe: --umask valeur umask
Variables: valeur_umask_
Valeur octale umask comprise entre 000 et 777.
Par défaut: Néant. Optim High Performance Unload utilisera la valeur umask du système cible.
Exemple: --umask 022

Utilisez cette option avec la commande db2hpu si vous n'êtes pas sûr de la version de Optim High Performance Unload est en cours d'exécution. L'option --version affiche la Optim High Performance Unload version actuellement en cours d'exécution, la version et le numéro de modification dans le format suivant :

vv.rr.mmm.ii

Le numéro de modification (mmm) correspond au numéro du dernier groupe de correctifs appliqué, et ii est le numéro du correctif temporaire.

Syntaxe: -v | --version
Variables: Néant.
Par défaut: Néant.

Utilisez cette option lorsque l'on souhaite exécuter Optim High Performance Unload avec une base de données d' Db2 Warehouse s distante comme source de données. Cette option est compatible uniquement avec l'option DB2 FORCE, car l'instruction SQL associée à une telle base de données Db2 Warehouse ne peut pas être exécutée autrement que via le moteur SQL Db2 . Par conséquent, dès lors que l'option de ligne de commande --warehouse est utilisée, si l'option DB2 n'est pas spécifiée explicitement, sa valeur par défaut devient FORCE. Si, en revanche, l'option DB2 est spécifiée explicitement et que sa valeur est YES ou NO, une erreur est retournée.

Syntaxe: --warehouse alias
Variables: alias; Indiquez le nom de la section d'entrepôt dans le fichier de données d'identification de l'utilisateur à prendre en compte pour la connexion à la base de données Db2 Warehouse distante.
Par défaut: Néant.