Lo strumento nz

nz è uno strumento per le istanze di IBM® Netezza® Performance Server for IBM Cloud Pak® for Data as a Service con cui è possibile accedere a NPSaaS. Con nz, puoi anche eseguire comandi in modo sicuro e da remoto tramite TLS / SSL per visualizzare, gestire e modificare vari aspetti delle tue istanze.

Su NPSaaS, le porte 5481, 5482 e 5483 non sono esposte per impostazione predefinita. Per emettere i comandi che passano attraverso tali porte, devi scaricare e utilizzare la riga di comando nz.

Piattaforme supportate per lo strumento nz:

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

Scaricare lo strumento " nz "

Lo nz strumento può essere scaricato utilizzando i seguenti metodi. Per le piattaforme cloud, si consiglia di eseguire il download dal server NPS utilizzando il metodo dell'interfaccia a riga di comando.

  1. Utilizzo dell'interfaccia a riga di comando

    Esegui il comando:

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

    dove l'API Server URL è API Server URL dettagli.

    Per richiamare queste informazioni, attenersi alla seguente procedura:

    1. Accedi al tuo account IBM Cloud.

    2. Vai a Elenco risorse > Servizi e software > Database.

    3. Fare clic sulla propria istanza di Netezza Performance Server. Ti trovi ora nella pagina Service instance details. Nella sezione Endpoint pubblici, è possibile trovare informazioni ( URL details) sugli endpoint per accedere alla console web, al server API e al database.

    Esempi:

    Per scaricare nz su una casella Linux, eseguire:

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

    Per scaricare nz su Windows, eseguire:

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

    È possibile scaricare il file nzcli da Fix Central.

La sintassi nz

Lo strumento nz supporta l'esecuzione di alcuni comandi NPSaaS e strumenti di supporto software. La sintassi dell'esecuzione del comando dipende dal tipo di comando - NPSaaS o Strumento di supporto software - e se è stato installato un comando di scelta rapida.

  1. Per un elenco dei comandi NPSaaS e degli strumenti di supporto software supportati, vedere Comandi supportati dallo strumento nz.
  2. L'esecuzione di uno strumento di supporto software richiede un comando di esecuzione: run, run-async, run-without-creds o run-show-progress.
  3. Per ulteriori informazioni sui collegamenti ai comandi, compresi i comandi che possono essere creati, vedere Creazione di collegamenti nz con il comando nz install.
  4. È possibile impostare le variabili d'ambiente APISERVER_URL, NZ_USER e NZ_PASSWORD e rinunciare a specificare le opzioni -apiserver, -u e -pw.

A partire da 11.2.2.10, è APISERVER_URL necessario utilizzare anziché l'argomento host. Per garantire prestazioni ottimali, è necessario riscaricare nz tool almeno ogni due release.

NPSaaS sintassi del comando

nz [command] [subcommands] [options]

Esempio:

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

NPSaaS sintassi delle scorciatoie da riga di comando

[command] [subcommand] [options]

Esempio:

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

Sintassi dello strumento di supporto software

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

Esempio:

./nz run nz_get_table_rowcount database1 table1

Comandi supportati dallo strumento nz

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

Quando si esegue un backup del database utilizzando nzbatchnbr, è necessario conservare l'ortografia originale del nome del database in backup.json.

  • Script degli strumenti di supporto software:
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

sintassi dell'installazione nz

  1. --dry-run: visualizza i collegamenti simbolici che verranno creati.
  2. --dest: directory in cui sono installati i collegamenti.
  3. --force: sovrascrive un collegamento preesistente.
nz install [--dry-run] [--dest DESTINATION-DIRECTORY] [--force]

Esempio:

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

Creazione di collegamenti nz con il comando nz install

È possibile creare collegamenti per i seguenti comandi comunemente utilizzati eseguendo il comando nz install. Di conseguenza, ad esempio, anziché eseguire nz nzstate, è possibile immettere nzstate.

nzbackup
nzbatchbnr
nzds
nzhw
nzrestore
nzrev
nzsession
nzstate
nzstats
nzsystem

variabili di ambiente nz

Impostare le variabili di ambiente APISERVER_URL, NZ_USER e NZ_PASSWORD per non specificare le opzioni -apiserver, -u e -pw quando si eseguono i comandi nz.

  • Dal terminale Linux o Mac OSX, esegui:

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

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

CLI

Per ulteriori informazioni sui comandi, consultare la sezione la CLI(command - line interface).

Formattazione del nome utente

  • Utilizzare un apice singolo seguito da doppi apici '" "' per i nomi utente che:

    • Contengono lettere minuscole.
    • Includere caratteri speciali diversi dal simbolo di sottolineatura _ o @.

    Esempio - Nome utente: SampleUser-> '"SampleUser"'

  • Per tutti gli altri nomi utente, i doppi apici "" sono facoltativi.

    Esempio - Nome utente: SAMPLEUSER-> SAMPLEUSER oppure "SAMPLEUSER"

Distinzione tra maiuscole e minuscole:

  • Utenti del database: I nomi utente non sono sensibili alle maiuscole e alle minuscole.

    Esempio - sample_user e SAMPLE_USER sono trattati allo stesso modo.

  • Utenti IBMIAM: I nomi utente sono sensibili alle maiuscole e alle minuscole.

    Esempio - sample_user@ibm.com e SAMPLE_USER@ibm.com sono trattati in modo diverso.

Strumento a riga di comando NZ - Aiuto

Una soluzione client sicura e flessibile per accedere a Netezza in ambienti cloud.

Sottocomandi

Comando Descrizione
auto-pr Elenco e visualizzazione dei dettagli del meccanismo di pausa/ripresa automatica
manualvacuum Eseguire l'operazione di aspirazione manuale (richiede il riavvio del sistema)

Comandi NZ di alto livello

Comandi Descrizione
bnr Operazioni di backup e ripristino
nzprogress Mostra tutti i piani in corso di realizzazione

Eseguire altri comandi NZ

Questi comandi consentono di eseguire vari comandi di nz sul sistema di destinazione:

Comandi Descrizione
ops Esegui comandi specifici per DevOps
pauseresume Pausa o ripresa dell'NPS
run Esegue qualsiasi comando nz consentito in modo sincrono (passa -u, -pw)
run-async Eseguire qualsiasi comando nz consentito in modo asincrono
run-show-progress Eseguire qualsiasi comando nz consentito, mostrando l'avanzamento immediato

Comandi di autorizzazione e ridimensionamento

Comando Descrizione
perms Ottenere e impostare le autorizzazioni
scale Scalare il calcolo e/o lo storage dell'NPS

Comando di impostazione

Comando Descrizione
configurazione-lh Configurazione della connessione LH per l'integrazione con Lakehouse

Comandi vari

Comandi Descrizione
versione Mostra la versione corrente del client NZ
installazione Installare i collegamenti simbolici per i comandi client NZ supportati
awsiam AWS Configurazione dell'autenticatore IAM

Comandi diretti dell'host NZ

Comandi Descrizione
nzbackup Chiamare lo strumento nzbackup
nzrestore Chiamare lo strumento nzrestore
nzsystem Chiamare lo strumento nzsystem
nzds Chiama lo strumento nzds
nzhw Chiama lo strumento nzhw
nzstate Chiamare lo strumento nzstate
nzbatchbnr Chiamare lo strumento nzbatchbnr
nzrev Chiamare lo strumento nzrev
nzstats Chiamare lo strumento nzstats
nzsession Chiamare lo strumento nzsession

Gestione dei fusi orari

  • timezone: Elenca o imposta il fuso orario sull'host NPS