L'outil nz

nz est un outil pour les instances IBM® Netezza® Performance Server for IBM Cloud Pak® for Data as a Service qui vous permet d'accéder à NPSaaS. Avec nz, vous pouvez également exécuter des commandes de manière sécurisée et à distance via TLS/SSL pour afficher, gérer et modifier divers aspects de vos instances.

Sur NPSaaS, les ports 5481, 5482 et 5483 ne sont pas exposés par défaut. Pour émettre les commandes qui passent par ces ports, vous devez télécharger et utiliser la ligne de commande nz.

Plateformes prises en charge par l'outil nz :

  • nz-darwin-amd64
  • nz-linux-amd64
  • nz-windows-amd64

Téléchargement de l'outil nz

L'outil nz peut être téléchargé à l'aide des méthodes suivantes. Pour les plateformes cloud, il est recommandé de télécharger depuis le serveur NPS à l'aide de la méthode d'interface de ligne de commande.

  1. Utilisation de l'interface en ligne de commande

    Exécutez la commande suivante :

    curl -o nz -k https://<API Server URL>/<version number>/download/<platform specific package>
    chmod +x nz
    

    où l' URL e du serveur API est l' URL e du serveur API.

    Pour extraire ces informations, procédez comme suit:

    1. Connectez-vous à votre compte IBM Cloud.

    2. Accédez à la liste des ressources > Services et logiciels > Bases de données.

    3. Cliquez sur votre instance d' Netezza Performance Server. Vous vous trouvez désormais sur la page des détails de l'instance du service. Dans la section Points de terminaison publics, vous trouverez des informations (détails de URL ) sur les points de terminaison permettant d'accéder à la console Web, au serveur API et à la base de données.

    Exemples :

    Pour télécharger nz sous Linux, exécutez:

    curl -o nz -k https://<API Server URL>/v2/download/nz-linux-amd64
    

    Pour télécharger nz sous Windows, exécutez:

    curl.exe -o nz.exe -k https://<API Server URL>/v2/download/nz-windows-amd64
    
  2. Télécharger à partir de fix-central

    Vous pouvez télécharger le nzcli à partir de Fix Central

La syntaxe nz

L'outil nz prend en charge l'exécution de certaines commandes NPSaaS et d'outils de support logiciel. La syntaxe d'exécution de la commande dépend du type de commande - NPSaaS ou outil de support logiciel, et de l'installation éventuelle d'un raccourci de commande.

  1. Pour une liste des NPSaaS et des outils de support logiciel pris en charge, voir Commandes prises en charge par l'outil nz.
  2. L'exécution d'un outil d'assistance logicielle nécessite une commande d'exécution : run, run-async, run-without-creds, ou run-show-progress.
  3. Pour plus d'informations sur les raccourcis de commande, notamment sur les commandes pour lesquelles des raccourcis peuvent être créés, voir Création de raccourcis nz avec la commande nz install.
  4. Vous pouvez définir les variables d'environnement APISERVER_URL, NZ_USER et NZ_PASSWORD et renoncer à spécifier les options -apiserver, -u et -pw.

À partir de 11.2.2.10, il APISERVER_URL faut utiliser à la place de l'argument host. Pour garantir des performances optimales, vous devez télécharger à nouveau l'outil nz au moins toutes les deux versions.

NPSaaS syntaxe des commandes

nz [command] [subcommands] [options]

Exemple :

./nz nzstate -apiserver <apiserver-url> -u <nps-admin-user> -pw <nps-admin-user-password>
System state is 'Online'.

NPSaaS Syntaxe des raccourcis de commande

[command] [subcommand] [options]

Exemple :

./nzstate -apiserver <apiserver-url> -u <nps-admin-user> -pw <nps-admin-user-password>
System state is 'Online'.

Syntaxe de l'outil d'assistance logicielle

nz [run-command] [software-support-tool] [subcommands] [options]

Exemple :

./nz run nz_get_table_rowcount database1 table1

Commandes prises en charge par l'outil nz

  • Commandes NPSaaS :
nzbackup
nzbatchbnr
nzds
nzhw
nzrestore
nzrev
nzstate
nzstats
nzsession
nzsystem
nzprogress
nzsqa

Lorsque vous effectuez une sauvegarde de votre base de données à l'aide de nzbatchnbr, vous devez conserver l'orthographe d'origine du nom de la base de données dans votre backup.json.

  • Scripts des outils de support logiciel :
nz_abort
nz_altered_tables
nz_backup_size_estimate
nz_best_practices
nz_build_html_help_output
nz_catalog_dump
nz_catalog_size
nz_change_owner
nz_check_ids
nz_check_statistics
nz_check_views
nz_cksum
nz_clone
nz_columns
nz_compiler_stats
nz_compressedTableRatio
nz_db_group_access_listing
nz_db_size
nz_db_tables_rowcount
nz_db_tables_rowcount_statistic
nz_db_user_access_listing
nz_db_views_rowcount
nz_ddl
nz_ddl_aggregate
nz_ddl_all_grants
nz_ddl_comment
nz_ddl_database
nz_ddl_diff
nz_ddl_ext_datasource
nz_ddl_ext_table
nz_ddl_function
nz_ddl_grant_group
nz_ddl_grant_role
nz_ddl_grant_user
nz_ddl_group
nz_ddl_history_config
nz_ddl_library
nz_ddl_mview
nz_ddl_object
nz_ddl_owner
nz_ddl_procedure
nz_ddl_role
nz_ddl_scheduler_rule
nz_ddl_schema
nz_ddl_security
nz_ddl_sequence
nz_ddl_synonym
nz_ddl_sysdef
nz_ddl_table
nz_ddl_table_redesign
nz_ddl_user
nz_ddl_view
nz_ddl_view+
nz_dimension_or_fact
nz_event_runAwayQuery
nz_find_32bit_udx
nz_find_control_chars_in_data
nz_find_non_integer_strings
nz_find_object
nz_find_object_orphans
nz_find_object_owners
nz_find_table_orphans
nz_fix_the_permissions
nz_frag
nz_genstats
nz_get
nz_get_acl
nz_get_admin
nz_get_aggregate_name
nz_get_aggregate_names
nz_get_aggregate_signatures
nz_get_column_attnum
nz_get_column_name
nz_get_column_names
nz_get_column_oid
nz_get_column_type
nz_get_database_name
nz_get_database_names
nz_get_database_objid
nz_get_database_owner
nz_get_database_table_column_names
nz_get_ext_datasource_name
nz_get_ext_datasource_names
nz_get_ext_table_name
nz_get_ext_table_names
nz_get_ext_table_objid
nz_get_ext_table_owner
nz_get_function_name
nz_get_function_names
nz_get_function_signatures
nz_get_group_name
nz_get_group_names
nz_get_group_objid
nz_get_group_owner
nz_get_group_users
nz_get_lastTXid
nz_get_library_name
nz_get_library_names
nz_get_mgmt_table_name
nz_get_mgmt_table_names
nz_get_mgmt_view_name
nz_get_mgmt_view_names
nz_get_model
nz_get_mview_basename
nz_get_mview_definition
nz_get_mview_matrelid
nz_get_mview_name
nz_get_mview_names
nz_get_mview_objid
nz_get_mview_owner
nz_get_object_name
nz_get_object_objid
nz_get_object_owner
nz_get_object_type
nz_get_procedure_name
nz_get_procedure_names
nz_get_procedure_signatures
nz_get_role_name
nz_get_role_names
nz_get_schema_name
nz_get_schema_names
nz_get_schema_objid
nz_get_sequence_name
nz_get_sequence_names
nz_get_sequence_objid
nz_get_sequence_owner
nz_get_stableTXid
nz_get_synonym_definition
nz_get_synonym_name
nz_get_synonym_names
nz_get_synonym_objid
nz_get_synonym_owner
nz_get_sysmgmt_table_name
nz_get_sysmgmt_table_names
nz_get_sysmgmt_table_objid
nz_get_sysmgmt_view_name
nz_get_sysmgmt_view_names
nz_get_sysmgmt_view_objid
nz_get_sys_table_name
nz_get_sys_table_names
nz_get_sys_view_name
nz_get_sys_view_names
nz_get_table_distribution_key
nz_get_table_fks
nz_get_table_name
nz_get_table_names
nz_get_table_objid
nz_get_table_organization_key
nz_get_table_owner
nz_get_table_pk
nz_get_table_rowcount
nz_get_table_rowcount_statistic
nz_get_user_groups
nz_get_user_name
nz_get_user_names
nz_get_user_objid
nz_get_user_owner
nz_get_view_definition
nz_get_view_name
nz_get_view_names
nz_get_view_objid
nz_get_view_owner
nz_get_view_rowcount
nz_grep_views
nz_groom
nz_host_memory
nz_inconsistent_data_types
nz_index
nz_invisible
nz_lock
nz_maintenance_mode
nz_migrate
nz_my_access
nz_my_grants
nz_objects
nz_online_vacuum
nz_permissions_audit
nz_physical_table_layout
nz_plan
nz_query
nz_query_history
nz_query_stats
nz_record_skew
nz_rerandomize
nz_rev
nz_responders
nz_set
nz_show_locks
nz_skew
nz_sort_order
nz_spu_memory
nz_spu_swap_space
nz_spu_top
nz_state
nz_stats
nz_storage_stats
nz_sysutil_stats
nz_table_analyze
nz_table_constraints
nz_table_references
nz_tables
nz_temporal
nz_test
nz_transactions
nz_truncate
nz_update_backup_status
nz_update_statistic_date_high_value
nz_update_statistic_length
nz_update_statistic_min_or_max
nz_update_statistic_null_values
nz_update_statistic_table_rowcount
nz_update_statistic_unique_values
nz_usage
nz_view_plan_file
nz_view_references
nz_wrapper
nz_zonemap

syntaxe d'installation nz

  1. --dry-run: affiche les liens symboliques qui seront créés.
  2. --dest: répertoire dans lequel les liens sont installés.
  3. --force: écrase un lien préexistant.
nz install [--dry-run] [--dest DESTINATION-DIRECTORY] [--force]

Exemple :

./nz install --dest /usr/local/bin --force
2024/09/13 09:18:09 main.go:131: Linking /root/nz -> /usr/local/bin/nzbackup
2024/09/13 09:18:09 main.go:131: Linking /root/nz -> /usr/local/bin/nzrestore
2024/09/13 09:18:09 main.go:131: Linking /root/nz -> /usr/local/bin/nzsystem
2024/09/13 09:18:09 main.go:131: Linking /root/nz -> /usr/local/bin/nzds
2024/09/13 09:18:09 main.go:131: Linking /root/nz -> /usr/local/bin/nzhw
2024/09/13 09:18:09 main.go:131: Linking /root/nz -> /usr/local/bin/nzstate
2024/09/13 09:18:09 main.go:131: Linking /root/nz -> /usr/local/bin/nzbatchbnr
2024/09/13 09:18:09 main.go:131: Linking /root/nz -> /usr/local/bin/nzrev
2024/09/13 09:18:09 main.go:131: Linking /root/nz -> /usr/local/bin/nzstats
2024/09/13 09:18:09 main.go:131: Linking /root/nz -> /usr/local/bin/nzsession

Création de raccourcis nz à l'aide de la commande nz install

Vous pouvez créer des raccourcis pour les commandes courantes suivantes en exécutant la commande nz install. Par exemple, au lieu d'exécuter nz nzstate, vous pouvez émettre nzstate.

nzbackup
nzbatchbnr
nzds
nzhw
nzrestore
nzrev
nzsession
nzstate
nzstats
nzsystem

Variables d'environnement nz

Définissez les variables d'environnement APISERVER_URL, NZ_USER et NZ_PASSWORD pour ne pas avoir à spécifier les options -apiserver, -u et -pw lorsque vous exécutez des commandes nz.

  • Sur un terminal Linux ou Mac OSX, exécutez :

    export APISERVER_URL=<api-server-url>
    export NZ_USER=<nps-admin-user>
    export NZ_PASSWORD=<nps-admin-user-password>
    
  • Sous Windows (cmd.exe), exécutez :

    set APISERVER_URL=<api-server-url>
    set NZ_USER=<nps-admin-user>
    set NZ_PASSWORD=<nps-admin-user-password>
    

Interface CLI

Pour plus d'informations sur les commandes, voir la section Interface de ligne de commande.

Formatage du nom d'utilisateur

  • Utilisez un guillemet simple suivi de guillemets doubles '" "' pour les noms d'utilisateur qui :

    • Contiennent des lettres minuscules.
    • Inclure des caractères spéciaux autres qu'un trait de soulignement _ ou un symbole @.

    Exemple - Nom d'utilisateur : SampleUser-> '"SampleUser"'

  • Pour tous les autres noms d'utilisateur, les doubles guillemets "" sont facultatifs.

    Exemple - Nom d'utilisateur : SAMPLEUSER-> SAMPLEUSER ou "SAMPLEUSER"

Respect de la casse:

  • Utilisateurs de la BD: Les noms d'utilisateur ne sont pas sensibles à la casse.

    Exemple - sample_user et SAMPLE_USER sont traités de la même manière.

  • Utilisateurs de l'IBMIAM: Les noms d'utilisateur sont sensibles à la casse.

    Exemple - sample_user@ibm.com et SAMPLE_USER@ibm.com sont traités différemment.

Outil en ligne de commande NZ - aide

Une solution client sécurisée et flexible pour accéder à Netezza dans des environnements en nuage.

Sous-commandes

Commande Description
auto-pr Liste et affichage des détails du mécanisme de pause/reprise automatique
manualvacuum Effectuer une opération de vidage manuel (nécessite un redémarrage du système)

Commandes NZ de haut niveau

Commandes Description
bnr Opérations de sauvegarde et de restauration
nzprogress Afficher tous les plans en cours

Exécuter d'autres commandes NZ

Ces commandes permettent d'exécuter diverses commandes nz sur le système cible :

Commandes Description
ops Exécuter des commandes dédiées aux DevOps
pauseresume Pause ou reprise NPS
run Exécuter n'importe quelle commande nz autorisée de manière synchrone (passe -u, -pw)
run-async Exécuter toute commande nz autorisée de manière asynchrone
run-show-progress Exécuter n'importe quelle commande nz autorisée en affichant la progression immédiate

Commandes de permission et de mise à l'échelle

Commande Description
perms Obtenir et définir des autorisations
scale Extension de la capacité de calcul et/ou de stockage de la NPS

Commande de configuration

Commande Description
setup-lh Configurer la connexion LH pour l'intégration Lakehouse

Autres commandes

Commandes Description
version Afficher la version actuelle du client NZ
installer Installer des liens symboliques pour les commandes client NZ prises en charge
awsiam AWS Configuration de l'authentificateur IAM

Commandes directes de l'hôte NZ

Commandes Description
nzbackup Appeler l'outil nzbackup
nzrestore Appeler l'outil nzrestore
nzsystem Appeler l'outil nzsystem
nzds Appeler l'outil nzds
nzhw Appeler l'outil nzhw
nzstate Appeler l'outil nzstate
nzbatchbnr Appeler l'outil nzbatchbnr
nzrev Appeler l'outil nzrev
nzstats Appeler l'outil nzstats
session nz Appeler l'outil nzsession

Gestion des fuseaux horaires

  • timezone: Liste ou définit le fuseau horaire de l'hôte NPS