IBM Cloud Docs
Lo strumento nz

Lo strumento nz

nz è uno strumento per le istanze IBM® Netezza® Performance Server for IBM Cloud Pak® for Data as a Service con cui puoi accedere a NPSaaS. Con nz, puoi anche eseguire i comandi in modo sicuro e remoto attraverso TLS/SSL per visualizzare, gestire e modificare i 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

Download dello strumento nz

È possibile scaricare lo strumento nz utilizzando i seguenti metodi:

  1. Utilizzo dell'interfaccia della 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 dalla versione 11.2.2.10, l'argomento APISERVER_URL deve essere utilizzato al posto dell'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 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

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: SAMPLEUSERSAMPLEUSER 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.