Das nz-Tool

nz ist ein Tool für IBM® Netezza® Performance Server for IBM Cloud Pak® for Data as a Service -Instanzen, mit dem Sie auf NPSaaSzugreifen können. Mit nzkönnen Sie Befehle auch auf sichere und ferne Weise über TLS/SSL ausführen, um verschiedene Aspekte Ihrer Instanzen anzuzeigen, zu verwalten und zu ändern.

Unter NPSaaSsind die Ports 5481, 5482 und 548 standardmäßig nicht zugänglich. Zum Absetzen der Befehle, die über diese Ports ausgeführt werden, müssen Sie die nz -Befehlszeile herunterladen und verwenden.

Unterstützte Plattformen für das Tool nz :

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

Das Tool nz herunterladen

Das nz Tool kann mit den folgenden Methoden heruntergeladen werden. Für Cloud-Plattformen wird empfohlen, den Download vom NPS-Server über die Befehlszeilenschnittstelle durchzuführen.

  1. Verwendung der Befehlszeilenschnittstelle

    Führen Sie den folgenden Befehl aus:

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

    wo der API-Server URL ist API-Server URL Details.

    Gehen Sie wie folgt vor, um diese Informationen abzurufen:

    1. Melden Sie sich bei Ihrem IBM Cloud-Konto an.

    2. Gehen Sie zu Ressourcenliste > Services und Software > Datenbanken.

    3. Klicken Sie auf Ihre Netezza Performance Server-Instanz. Sie befinden sich nun auf der Seite mit den Details zur Service-Instanz. Im Abschnitt Öffentliche Endpunkte finden Sie Informationen (Details zu URL ) zu den Endpunkten für den Zugriff auf die Webkonsole, den API-Server und die Datenbank.

    Beispiele:

    Führen Sie den folgenden Befehl aus, um nz unter einem Linux-Fenster herunterzuladen:

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

    Führen Sie den folgenden Befehl aus, um nz unter Windows herunterzuladen:

    curl.exe -o nz.exe -k https://<API Server URL>/v2/download/nz-windows-amd64
    
  2. Herunterladen von fix-central

    Sie können die nzcli von Fix Central herunterladen.

nz-Syntax

Das nz Tool unterstützt die Ausführung ausgewählter NPSaaS Befehle und Software Support Tools. Die Syntax der Befehlsausführung hängt vom Befehlstyp ab - NPSaaS-Befehl oder Software Support Tool - und davon, ob eine Befehlsverknüpfung installiert wurde.

  1. Eine Liste der unterstützten NPSaaS-Befehle und Software Support Tools finden Sie unter Befehle, die vom nz-Tool unterstützt werden.
  2. Die Ausführung eines Software Support Tools erfordert einen Ausführungsbefehl: run, run-async, run-without-creds, oder run-show-progress.
  3. Weitere Informationen über Befehlsverknüpfungen, einschließlich der Befehle, für die Verknüpfungen erstellt werden können, finden Sie unter Erstellen von nz-Verknüpfungen mit dem Befehl nz install.
  4. Sie können die Umgebungsvariablen APISERVER_URL, NZ_USER und NZ_PASSWORD setzen und auf die Angabe der Optionen -apiserver, -u und -pw verzichten.

Beginnend mit 11.2.2.10 muss APISERVER_URL anstelle des Host-Arguments verwendet werden. Um eine optimale Leistung zu gewährleisten, sollten Sie das Tool nz mindestens alle zwei Jahre neu herunterladen.

NPSaaS Befehlssyntax

nz [command] [subcommands] [options]

Beispiel:

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

NPSaaS Syntax von Befehls-Shortcuts

[command] [subcommand] [options]

Beispiel:

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

Syntax des Software-Support-Tools

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

Beispiel:

./nz run nz_get_table_rowcount database1 table1

Vom nz-Tool unterstützte Befehle

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

Wenn Sie eine Sicherung Ihrer Datenbank mit nzbatchnbr erstellen, müssen Sie die ursprüngliche Schreibweise des Datenbanknamens in Ihrem backup.json beibehalten.

  • Software Support Tools-Scripts:
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

nz-Installationssyntax

  1. --dry-run: zeigt die Symlinks an, die erstellt werden.
  2. --dest: Verzeichnis, in dem Links installiert sind.
  3. --force: überschreibt einen bereits bestehenden Link.
nz install [--dry-run] [--dest DESTINATION-DIRECTORY] [--force]

Beispiel:

./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

nz-Verknüpfungen mit dem nz-Installationsbefehl erstellen

Sie können Direktaufrufe für die folgenden häufig verwendeten Befehle erstellen, indem Sie den Befehl nz install ausführen. Daher können Sie beispielsweise anstelle von nz nzstateden Befehl nzstateausgeben.

nzbackup
nzbatchbnr
nzds
nzhw
nzrestore
nzrev
nzsession
nzstate
nzstats
nzsystem

nz-Umgebungsvariablen

Legen Sie die Umgebungsvariablen APISERVER_URL, NZ_USERund NZ_PASSWORD so fest, dass bei der Ausführung von nz -Befehlen auf die Angabe der Optionen -apiserver, -uund -pw verzichtet wird.

  • Führen Sie im Linux -oder Mac OSX-Terminal Folgendes aus:

    export APISERVER_URL=<api-server-url>
    export NZ_USER=<nps-admin-user>
    export NZ_PASSWORD=<nps-admin-user-password>
    
  • Führen Sie unter Windows (cmd.exe) Folgendes aus:

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

Befehlszeilenschnittstelle

Weitere Informationen zu Befehlen finden Sie im Abschnitt Befehlszeilenschnittstelle.

Formatierung des Benutzernamens

  • Verwenden Sie ein einfaches Anführungszeichen gefolgt von doppelten Anführungszeichen '" "' für Benutzernamen, die:

    • Enthält Kleinbuchstaben.
    • Sonderzeichen außer dem Unterstrich _ oder dem Symbol @ einschließen.

    Beispiel - Benutzername: SampleUser-> '"SampleUser"'

  • Bei allen anderen Benutzernamen sind die doppelten Anführungszeichen "" optional.

    Beispiel - Benutzername: SAMPLEUSER-> SAMPLEUSER oder "SAMPLEUSER"

Groß-/Kleinschreibung:

  • DB-Benutzer: Bei den Benutzernamen wird nicht zwischen Groß- und Kleinschreibung unterschieden.

    Beispiel - sample_user und SAMPLE_USER werden gleich behandelt.

  • IBMIAM-Benutzer: Bei den Benutzernamen wird zwischen Groß- und Kleinschreibung unterschieden.

    Beispiel - sample_user@ibm.com und SAMPLE_USER@ibm.com werden unterschiedlich behandelt.

NZ-Befehlszeilentool – Hilfe

Eine sichere und flexible Client-Lösung für den Zugriff auf Netezza in Cloud-Umgebungen.

Unterbefehle

Befehl Beschreibung
auto-pr Auflisten und Anzeigen der Details des Mechanismus für die automatische Pause/Fortsetzung
manualvacuum Manuellen Vakuumbetrieb ausführen (erfordert einen Systemneustart)

Hochrangige NZ-Befehle

Befehle Beschreibung
bnr Sicherungs- und Wiederherstellungsvorgänge
nzprogress Alle derzeit in Arbeit befindlichen Pläne anzeigen

Andere NZ-Befehle ausführen

Mit diesen Befehlen können verschiedene nz Befehle auf dem Zielsystem ausgeführt werden:

Befehle Beschreibung
ops DevOps-spezifische Befehle ausführen
pauseresume NPS anhalten oder fortsetzen
run Jeden erlaubten nz-Befehl synchron ausführen (übergibt -u, -pw)
run-async Jeden zulässigen nz-Befehl asynchron ausführen
run-show-progress Jeden erlaubten nz-Befehl ausführen und sofortigen Fortschritt anzeigen

Befugnisse und Skalierungsbefehle

Befehl Beschreibung
perms Berechtigungen abrufen und festlegen
scale Skalierung von NPS-Rechenleistung und/oder Speicher

Setup-Befehl

Befehl Beschreibung
setup-lh Einrichten der LH-Verbindung für die Lakehouse-Integration

Sonstige Befehle

Befehle Beschreibung
Version Anzeige der aktuellen Version des NZ-Clients
installieren Installation von Symlinks für unterstützte NZ-Client-Befehle
awsiam AWS IAM-Authentifikator-Einrichtung

Direkte NZ-Host-Befehle

Befehle Beschreibung
nzbackup Aufruf des Tools nzbackup
nzrestore Werkzeug nzrestore aufrufen
nzsystem Werkzeug nzsystem aufrufen
nzds Nzds-Tool aufrufen
nzhw Nzhw-Tool aufrufen
nzstate Nzstate-Tool aufrufen
nzbatchbnr Aufruf des Tools nzbatchbnr
nzrev Nzrev-Tool aufrufen
nzstats Werkzeug nzstats aufrufen
nzsession Nzsession-Tool aufrufen

Verwaltung von Zeitzonen

  • zeitzone: Zeitzone auf dem NPS-Host auflisten oder einstellen