IBM Cloud Docs
nz 工具

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-amd64
  • nz-linux-amd64
  • nz-windows-amd64

下載 nz 工具

您可以透過以下方式下載 nz 工具:

  1. 使用指令列介面

    請執行以下指令:

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

    其中 API Server URL 為 API Server URL 詳細資訊。

    若要擷取此資訊,請遵循下列步驟:

    1. 登入 IBM Cloud 帳戶。

    2. 移至 資源清單 > 服務及軟體 > 資料庫

    3. 按一下 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
    
  2. 從修復中心下載

    您可以從 Fix Central 下載 nzcli

nz 語法

nz 工具支援執行選定的NPSaaS指令和軟體支援工具。 指令執行語法取決於指令類型 - NPSaaS指令或軟體支援工具,以及是否安裝了快速指令。

  1. 有關支援的NPSaaS命令和軟體支援工具的列表,請參閱 nz 工具支援的命令
  2. 軟體支援工具的執行需要執行指令:runrun-asyncrun-without-credsrun-show-progress
  3. 有關命令快捷方式的更多信息,包括哪些命令可以建立快捷方式,請參閱 使用 nz install 命令建立 nz 快捷方式
  4. 您可以設定 APISERVER_URLNZ_USERNZ_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

當您使用 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 安裝語法

  1. --dry-run:顯示將建立的符號連結。
  2. --dest:安裝連結的目錄。
  3. --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_URLNZ_USERNZ_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_userSAMPLE_USER 受到同樣的待遇。

  • IBMIAM 用戶:使用者名稱區分大小寫。

    例子 -sample_user@ibm.comSAMPLE_USER@ibm.com 受到不同的對待。

NZ 指令行工具 - 說明

安全且彈性的用戶端解決方案,可在雲端環境中存取 Netezza。

子指令

指令 說明
auto-pr 列出並顯示自動暫停/繼續機制的詳細資訊

高階 NZ 指令

指令 說明
bnr 備份與還原作業
nzprogress 顯示目前進行中的所有計劃

執行其他 NZ 指令

這些指令允許在目標系統上執行各種 nz 指令:

指令 說明
pauseresume 暫停或恢復 NPS
run 同步執行任何允許的 nz 指令 (passes -u, -pw)
run-async 以非同步方式執行任何允許的 nz 指令
run-show-progress 執行任何允許的 nz 指令,顯示即時進度

權限和縮放指令

指令 說明
perms 取得及設定權限
scale 擴充 NPS 計算機和/或儲存設備

設定指令

指令 說明
設定-hms 設定 HMS 連線以整合湖畔小屋

雜項指令

指令 說明
版本 顯示 NZ 用戶端的目前版本
安裝 為支援的 NZ 用戶端指令安裝 symlinks
AWS IAM 認證器設定

直接 NZ 主機指令

指令 說明
nzbackup 呼叫 nzbackup 工具
nzrestore 呼叫 nzrestore 工具
nzsystem 呼叫 nzsystem 工具
nzds 呼叫 nzds 工具
nzhw 呼叫 nzhw 工具
nzstate 呼叫 nzstate 工具
nzbatchbnr 呼叫 nzbatchbnr 工具
nzrev 呼叫 nzrev 工具
nzstats 呼叫 nzstats 工具
nzsession 呼叫 nzsession 工具

時區管理

  • 時區列出或設定 NPS 主機的時區