nz 工具
nz 是適用於 IBM® Netezza® Performance Server for IBM Cloud Pak® for Data as a Service 實例的工具,可透過此工具存取 NPSaaS。 透過 nz,您亦可透過 TLS / SSL 以安全且遠端的方式執行指令,藉此檢視、管理及修改您實例的各項設定。
在 NPSaaS上,依預設不會公開埠 5481、5482 和 5483。 若要發出通過那些埠的指令,您必須下載並使用 nz 指令行。
nz 工具支援的平台:
nz-darwin-amd64nz-linux-amd64nz-windows-amd64
下載「nz」工具
此 nz 工具可透過以下方式下載: 針對雲端平台,建議採用命令列介面方式從 NPS 伺服器下載。
-
使用命令列介面
請執行以下指令:
curl -o nz -k https://<API Server URL>/<version number>/download/<platform specific package> chmod +x nz其中 API Server URL 為 API Server URL 詳細資訊。
若要擷取此資訊,請遵循下列步驟:
-
登入 IBM Cloud 帳戶。
-
移至 資源清單 > 服務及軟體 > 資料庫。
-
按一下 Netezza Performance Server 實例。 您現在位於 服務實例詳細資料 頁面上。 在 Public Endpoints (公共端點 ) 區段中,您可以找到有關存取 Web 主控台、API 伺服器和資料庫的端點資訊 ( URL 詳細資訊)。
範例:
若要在 Linux 方框上下載
nz,請執行:curl -o nz -k https://<API Server URL>/v2/download/nz-linux-amd64若要在 Windows 上下載
nz,請執行:curl.exe -o nz.exe -k https://<API Server URL>/v2/download/nz-windows-amd64 -
-
從修復中心下載
您可以從 Fix Central 下載
nzcli。
nz 語法
nz 工具支援執行選定的NPSaaS指令和軟體支援工具。 指令執行語法取決於指令類型 - NPSaaS指令或軟體支援工具,以及是否安裝了快速指令。
- 有關支援的NPSaaS命令和軟體支援工具的列表,請參閱 nz 工具支援的命令。
- 軟體支援工具的執行需要執行指令:
run、run-async、run-without-creds或run-show-progress。 - 有關命令快捷方式的更多信息,包括哪些命令可以建立快捷方式,請參閱 使用 nz install 命令建立 nz 快捷方式。
- 您可以設定
APISERVER_URL、NZ_USER和NZ_PASSWORD環境變量,並放棄指定 -apiserver、-u 和 -pw 選項。
從 11.2.2.10 開始,必須 APISERVER_URL 使用 取代主機參數。 為了確保最佳效能,您應該至少每隔一個版本重新下載 nz 工具。
NPSaaS 指令語法
nz [command] [subcommands] [options]
範例:
./nz nzstate -apiserver <apiserver-url> -u <nps-admin-user> -pw <nps-admin-user-password>
System state is 'Online'.
NPSaaS 指令快捷鍵語法
[command] [subcommand] [options]
範例:
./nzstate -apiserver <apiserver-url> -u <nps-admin-user> -pw <nps-admin-user-password>
System state is 'Online'.
軟體支援工具的語法
nz [run-command] [software-support-tool] [subcommands] [options]
範例:
./nz run nz_get_table_rowcount database1 table1
nz 工具支援的指令
- NPSaaS 指令:
nzbackup
nzbatchbnr
nzds
nzhw
nzrestore
nzrev
nzstate
nzstats
nzsession
nzsystem
nzprogress
nzsqa
當您使用 nzbatchnbr 來備份資料庫時,必須在 backup.json 中保留資料庫名稱的原始拼字。
- 軟體支援工具 Script:
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 安裝語法
--dry-run:顯示將建立的符號連結。--dest:安裝連結的目錄。--force:覆蓋預先存在的連結。
nz install [--dry-run] [--dest DESTINATION-DIRECTORY] [--force]
範例:
./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 install 指令建立 nz 捷徑
您可以執行 nz install 指令,為下列常用指令建立捷徑。 因此,例如,您可以發出 nzstate,而不是執行 nz nzstate。
nzbackup
nzbatchbnr
nzds
nzhw
nzrestore
nzrev
nzsession
nzstate
nzstats
nzsystem
nz 環境變數
設定 APISERVER_URL、NZ_USER 及 NZ_PASSWORD 環境變數,以在執行 nz 指令時放棄指定 -apiserver、-u 及 -pw 選項。
-
從 Linux 或 Mac OSX 終端機,執行:
export APISERVER_URL=<api-server-url> export NZ_USER=<nps-admin-user> export NZ_PASSWORD=<nps-admin-user-password> -
從 Windows (
cmd.exe),執行:set APISERVER_URL=<api-server-url> set NZ_USER=<nps-admin-user> set NZ_PASSWORD=<nps-admin-user-password>
CLI
如需指令的相關資訊,請參閱 指令行介面 一節。
使用者名稱格式
-
使用單引號,後面跟著雙引號
'" "'對於使用者名稱:- 包含小寫字母。
- 包含底線以外的特殊字符
_或者@象徵。
範例 - 使用者名稱:
SampleUser->'"SampleUser"' -
對於所有其他用戶名,使用雙引號
""是可選的。例如 - 使用者名稱:
SAMPLEUSER->SAMPLEUSER或"SAMPLEUSER"
大小寫敏感性:
-
資料庫用戶: 使用者名稱不區分大小寫。
例子 -
sample_user和SAMPLE_USER受到同樣的待遇。 -
IBMIAM 用戶:使用者名稱區分大小寫。
例子 -
sample_user@ibm.com和SAMPLE_USER@ibm.com受到不同的對待。
NZ 指令行工具 - 說明
安全且彈性的用戶端解決方案,可在雲端環境中存取 Netezza。
子指令
| 指令 | 說明 |
|---|---|
auto-pr |
列出並顯示自動暫停/繼續機制的詳細資訊 |
manualvacuum |
執行手動真空操作(需重新啟動系統) |
高階 NZ 指令
| 指令 | 說明 |
|---|---|
bnr |
備份與還原作業 |
nzprogress |
顯示目前進行中的所有計劃 |
執行其他 NZ 指令
這些指令允許在目標系統上執行各種 nz 指令:
| 指令 | 說明 |
|---|---|
ops |
執行 DevOps 專用指令 |
pauseresume |
暫停或恢復 NPS |
run |
同步執行任何允許的 nz 指令 (passes -u, -pw) |
run-async |
以非同步方式執行任何允許的 nz 指令 |
run-show-progress |
執行任何允許的 nz 指令,顯示即時進度 |
權限和縮放指令
| 指令 | 說明 |
|---|---|
perms |
取得及設定權限 |
scale |
擴充 NPS 計算機和/或儲存設備 |
設定指令
| 指令 | 說明 |
|---|---|
| setup-lh | 設定 lh 連線以進行 Lakehouse 整合 |
雜項指令
| 指令 | 說明 |
|---|---|
| 版本 | 顯示 NZ 用戶端的目前版本 |
| 安裝 | 為支援的 NZ 用戶端指令安裝 symlinks |
| 賢 | AWS IAM 認證器設定 |
直接 NZ 主機指令
| 指令 | 說明 |
|---|---|
| 紐西蘭備份 | 呼叫 nzbackup 工具 |
| 紐西蘭復原 | 呼叫 nzrestore 工具 |
| nzsystem | 呼叫 nzsystem 工具 |
| 紐西蘭元 | 呼叫 nzds 工具 |
| nzhw | 呼叫 nzhw 工具 |
| 紐西蘭州 | 呼叫 nzstate 工具 |
| nzbatchbnr | 呼叫 nzbatchbnr 工具 |
| nzrev | 呼叫 nzrev 工具 |
| 紐西蘭統計局 | 呼叫 nzstats 工具 |
| nzsession | 呼叫 nzsession 工具 |
時區管理
- 時區列出或設定 NPS 主機的時區