La herramienta nz
nz es una herramienta para las instancias de IBM® Netezza® Performance Server for IBM Cloud Pak® for Data as a Service con las que puede acceder a NPSaaS. Con nz, también puede ejecutar mandatos de forma segura y remota
a través de TLS/SSL para ver, gestionar y modificar varios aspectos de las instancias.
En NPSaaS, los puertos 5481, 5482 y 5483 no están expuestos de forma predeterminada. Para emitir los mandatos que pasan por esos puertos, debe descargar y utilizar la línea de mandatos de nz.
Plataformas soportadas para la herramienta nz:
nz-darwin-amd64nz-linux-amd64nz-windows-amd64
Descarga de la herramienta nz
La nz herramienta se puede descargar utilizando los siguientes métodos. Para las plataformas en la nube, se recomienda descargar desde el servidor NPS utilizando el método de interfaz comando línea de comandos.
-
Utilizando la interfaz de línea comando
Ejecute el mandato:
curl -o nz -k https://<API Server URL>/<version number>/download/<platform specific package> chmod +x nzdonde el API Server URL es API Server URL detalles.
Para recuperar esta información, siga estos pasos:
-
Inicie sesión en la cuenta de IBM Cloud.
-
Ve a Lista de recursos > Servicios y software > Bases de datos.
-
Haz clic en tu instancia de Netezza Performance Server. Ahora se encuentra en la página de detalles de la instancia del servicio. En la sección Puntos de conexión públicos, encontrará información (detalles de URL ) sobre los puntos de conexión para acceder a la consola web, al servidor de API y a la base de datos.
Ejemplos:
Para descargar
nzen un recuadro Linux, ejecute:curl -o nz -k https://<API Server URL>/v2/download/nz-linux-amd64Para descargar
nzen Windows, ejecute:curl.exe -o nz.exe -k https://<API Server URL>/v2/download/nz-windows-amd64 -
-
Descargar de fix-central
Puedes descargar el
nzclidesde Fix Central.
La sintaxis de nz
La herramienta nz admite la ejecución de comandos selectos NPSaaS y herramientas de soporte de software. La sintaxis de ejecución del comando depende del tipo de comando - NPSaaS o Herramienta de soporte de software, y de si se
ha instalado un comando de acceso directo.
- Para obtener una lista de comandos NPSaaS y herramientas de soporte de software compatibles, consulte Comandos compatibles con la herramienta nz.
- La ejecución de una herramienta de soporte de software requiere un comando de ejecución:
run,run-async,run-without-creds, orun-show-progress. - Para obtener más información sobre los accesos directos de comandos, incluidos los comandos para los que se pueden crear accesos directos, consulte Creación de accesos directos nz con el comando nz install.
- Puede establecer las variables de entorno
APISERVER_URL,NZ_USERyNZ_PASSWORDy no especificar las opciones -apiserver, -u y -pw.
A partir de 11.2.2.10, se APISERVER_URL debe utilizar en lugar del argumento host. Para garantizar un rendimiento óptimo, debería volver a descargar nz la herramienta al menos cada dos versiones.
NPSaaS sintaxis comando
nz [command] [subcommands] [options]
Ejemplo:
./nz nzstate -apiserver <apiserver-url> -u <nps-admin-user> -pw <nps-admin-user-password>
System state is 'Online'.
NPSaaS Sintaxis de los atajos de comando
[command] [subcommand] [options]
Ejemplo:
./nzstate -apiserver <apiserver-url> -u <nps-admin-user> -pw <nps-admin-user-password>
System state is 'Online'.
Sintaxis de la herramienta de soporte de software
nz [run-command] [software-support-tool] [subcommands] [options]
Ejemplo:
./nz run nz_get_table_rowcount database1 table1
Mandatos soportados por la herramienta nz
- Mandatos de NPSaaS:
nzbackup
nzbatchbnr
nzds
nzhw
nzrestore
nzrev
nzstate
nzstats
nzsession
nzsystem
nzprogress
nzsqa
Cuando realice una copia de seguridad de la base de datos utilizando nzbatchnbr, debe conservar la ortografía original del nombre de la base de datos en backup.json.
- Scripts de herramientas de soporte de 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
nz instalar sintaxis
--dry-run: muestra los enlaces simbólicos que se crearán.--dest: directorio donde se instalan los enlaces.--force: sobrescribe un enlace preexistente.
nz install [--dry-run] [--dest DESTINATION-DIRECTORY] [--force]
Ejemplo:
./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
Creación de accesos directos de nz con el mandato de instalación de nz
Puede crear accesos directos para los siguientes mandatos utilizados habitualmente ejecutando el mandato nz install. Como resultado, por ejemplo, en lugar de ejecutar nz nzstate, puede emitir nzstate.
nzbackup
nzbatchbnr
nzds
nzhw
nzrestore
nzrev
nzsession
nzstate
nzstats
nzsystem
Variables de entorno nz
Establezca las variables de entorno APISERVER_URL, NZ_USER y NZ_PASSWORD para obviar la especificación de las opciones -apiserver, -uy -pw cuando ejecute mandatos
de nz.
-
Desde el terminal de Linux o Mac OSX, ejecute:
export APISERVER_URL=<api-server-url> export NZ_USER=<nps-admin-user> export NZ_PASSWORD=<nps-admin-user-password> -
Desde Windows (
cmd.exe), ejecute:set APISERVER_URL=<api-server-url> set NZ_USER=<nps-admin-user> set NZ_PASSWORD=<nps-admin-user-password>
CLI
Para obtener más información sobre los mandatos, consulte la sección la interfaz de línea de mandatos.
Formato del nombre de usuario
-
Utilice una comilla simple seguida de comillas dobles
'" "'para los nombres de usuario que:- Contener letras minúsculas.
- Incluya caracteres especiales que no sean un guión bajo
_o un símbolo@.
Ejemplo - Nombre de usuario:
SampleUser->'"SampleUser"' -
Para todos los demás nombres de usuario, las comillas dobles
""son opcionales.Ejemplo - Nombre de usuario:
SAMPLEUSER->SAMPLEUSERo"SAMPLEUSER"
Distinción entre mayúsculas y minúsculas:
-
Usuarios BD: Los nombres de usuario no distinguen entre mayúsculas y minúsculas.
Ejemplo -
sample_userySAMPLE_USERse tratan igual. -
IBMIAM Usuarios: Los nombres de usuario distinguen entre mayúsculas y minúsculas.
Ejemplo -
sample_user@ibm.comySAMPLE_USER@ibm.comse tratan de forma diferente.
Herramienta de línea comando NZ: ayuda
Una solución cliente segura y flexible para acceder a Netezza en entornos de nube.
Submandatos
| Mandato | Descripción |
|---|---|
auto-pr |
Listar y mostrar detalles del mecanismo de Auto Pausa/Reanudar |
manualvacuum |
Realizar una operación de limpieza manual (requiere reiniciar el sistema) |
Comandos NZ de alto nivel
| Mandatos | Descripción |
|---|---|
bnr |
Operaciones de copia de seguridad y restauración |
nzprogress |
Mostrar todos los planes en curso |
Ejecutar otros comandos NZ
Estos comandos permiten ejecutar varios comandos de nz en el sistema de destino:
| Mandatos | Descripción |
|---|---|
ops |
Ejecutar comandos específicos de DevOps |
pauseresume |
Pausar o reanudar NPS |
run |
Ejecuta cualquier comando nz permitido de forma sincrónica (pasa por -u, -pw) |
run-async |
Ejecutar cualquier comando nz permitido de forma asíncrona |
run-show-progress |
Ejecutar cualquier comando nz permitido mostrando el progreso inmediato |
Comandos de permiso y escalado
| Mandato | Descripción |
|---|---|
perms |
Obtener y establecer permisos |
scale |
Ampliación de los recursos informáticos y de almacenamiento del NPS |
Comando de configuración
| Mandato | Descripción |
|---|---|
| setup-lh | Configurar la conexión LH para la integración de Lakehouse |
Mandatos varios
| Mandatos | Descripción |
|---|---|
| versión | Mostrar la versión actual del cliente NZ |
| Instalar | Instalar enlaces simbólicos para los comandos de cliente NZ compatibles |
| awsiam | AWS Configuración del autenticador IAM |
Comandos directos de host NZ
| Mandatos | Descripción |
|---|---|
| nzbackup | Llamar a la herramienta nzbackup |
| nzrestore | Llamar a la herramienta nzrestore |
| nzsystem | Llamar a la herramienta nzsystem |
| nzds | Llamar a la herramienta nzds |
| nzhw | Llamar a la herramienta nzhw |
| nzstate | Llamar a la herramienta nzstate |
| nzbatchbnr | Llamar a la herramienta nzbatchbnr |
| nzrev | Llamar a la herramienta nzrev |
| nzstats | Llamar a la herramienta nzstats |
| nzsession | Llamar a la herramienta nzsession |
Gestión de la zona horaria
- zona horaria: Lista o establece la zona horaria en el host NPS