產生翻譯和評估的中繼資料

在產生資料庫記錄或擷取中繼資料時，開啟評估模式。 使用 dwh-migration-dumper 工具擷取中繼資料時，系統會產生 BigQuery 遷移評估所需的中繼資料統計資料。用於查詢記錄時，這個指令會擷取額外資料欄，以評估 BigQuery 遷移作業。

以半形逗號分隔的資料庫清單，視 Teradata 伺服器設定而定，資料庫名稱可能區分大小寫。

如果這個旗標與 teradata 連接器一併使用，dwh-migration-dumper 工具會根據提供的資料庫清單，篩選中繼資料表和檢視區塊。例外狀況是 DatabasesV 和 RoleMembersV 檢視畫面，dwh-migration-dumper 工具會從這些檢視畫面中擷取資料庫和使用者，不會依資料庫名稱篩選。

這個旗標無法與 teradata-logs 連接器搭配使用。系統一律會擷取所有資料庫的查詢記錄。

資料庫連線要使用的使用者名稱。

僅適用於 teradata-logs 連接器。

如要從其他位置擷取查詢記錄，建議改用 -Dteradata-logs.query-logs-table 和 -Dteradata-logs.sql-logs-table 標記。

根據預設，查詢記錄會從 dbc.DBQLogTbl 和 dbc.DBQLSQLTbl 資料表擷取。如果您使用 --assessment 旗標，系統會從檢視區塊 dbc.QryLogV 和資料表 dbc.DBQLSQLTbl 擷取查詢記錄。如要從其他位置擷取查詢記錄，可以使用 --query-log-alternates 旗標指定資料表或檢視區塊的完整名稱。第一個參數會參照 dbc.DBQLogTbl 資料表的替代項目，第二個參數則會參照 dbc.DBQLSQLTbl 資料表的替代項目。這兩個參數都必須提供。
如果兩個資料表都有 DATE 類型的索引欄，可以使用 -Dteradata-logs.log-date-column 旗標提升擷取效能。

示例： --query-log-alternates historicdb.ArchivedQryLogV,historicdb.ArchivedDBQLSqlTbl

連線的交易模式。支援的值如下：

• ANSI：ANSI 模式。這是預設模式 (如未指定旗標)
• TERA：Teradata 交易模式 (BTET)
• DEFAULT：使用資料庫伺服器上設定的預設交易模式
• NONE：未設定連線模式

範例 (Bash)：
-Dteradata.tmode=TERA

範例 (Windows PowerShell)：
"-Dteradata.tmode=TERA"

僅適用於 teradata-logs 連接器。

如要提升由 -Dteradata-logs.query-logs-table 和 -Dteradata-logs.sql-logs-table 標記指定的聯結資料表效能，可以在 JOIN 條件中加入 DATE 類型的額外資料欄。這個資料欄必須在兩個資料表中定義，且必須是分區主索引的一部分。

範例 (Bash)：
-Dteradata-logs.log-date-column=ArchiveLogDate

範例 (Windows PowerShell)：
"-Dteradata-logs.log-date-column=ArchiveLogDate"

僅適用於 teradata-logs 連接器。

根據預設，查詢記錄會從 dbc.DBQLogTbl 表格擷取。如果您使用 --assessment 旗標，系統會從檢視區塊 dbc.QryLogV 擷取查詢記錄。如要從其他位置擷取查詢記錄，可以使用這個標記指定資料表或檢視的完整名稱。
請參閱 -Dteradata-logs.log-date-column 旗標，瞭解如何提升擷取效能。

範例 (Bash)：
-Dteradata-logs.query-logs-table=historicdb.ArchivedQryLogV

範例 (Windows PowerShell)：
"-Dteradata-logs.query-logs-table=historicdb.ArchivedQryLogV"

僅適用於 teradata-logs 連接器。

根據預設，系統會從 dbc.DBQLSqlTbl 資料表擷取含有 SQL 文字的查詢記錄。如需從替代位置擷取這些檔案，您可以使用這個標記指定表格或檢視的完整名稱。
請參閱 -Dteradata-logs.log-date-column 旗標，瞭解如何提升擷取效能。

範例 (Bash)：
-Dteradata-logs.sql-logs-table=historicdb.ArchivedDBQLSqlTbl

範例 (Windows PowerShell)：
"-Dteradata-logs.sql-logs-table=historicdb.ArchivedDBQLSqlTbl"

僅適用於 teradata-logs 連接器。

根據預設，公用程式記錄檔會從表格中擷取 dbc.DBQLUtilityTbl。如要從其他位置擷取公用程式記錄，可以使用 -Dteradata-logs.utility-logs-table 標記指定資料表的完整名稱。

範例 (Bash)：
-Dteradata-logs.utility-logs-table=historicdb.ArchivedUtilityLogs

範例 (Windows PowerShell)：
"-Dteradata-logs.utility-logs-table=historicdb.ArchivedUtilityLogs"

僅適用於 teradata-logs 連接器。

根據預設，SCPU 資源用量記錄會從 dbc.ResUsageScpu 資料表擷取。如要從其他位置擷取這些項目，可以使用 -Dteradata-logs.res-usage-scpu-table 標記指定資料表的完整名稱。

範例 (Bash)：
-Dteradata-logs.res-usage-scpu-table=historicdb.ArchivedResUsageScpu

範例 (Windows PowerShell)：
"-Dteradata-logs.res-usage-scpu-table=historicdb.ArchivedResUsageScpu"

僅適用於 teradata-logs 連接器。

根據預設，系統會從 dbc.ResUsageSpma 表格中擷取 SPMA 資源用量記錄。如要從其他位置擷取這些記錄，可以使用 -Dteradata-logs.res-usage-spma-table 標記指定資料表的完整名稱。

範例 (Bash)：
-Dteradata-logs.res-usage-spma-table=historicdb.ArchivedResUsageSpma

範例 (Windows PowerShell)：
"-Dteradata-logs.res-usage-spma-table=historicdb.ArchivedResUsageSpma"

要擷取查詢記錄的開始時間 (含此時間)。這個值會截斷至小時。這個旗標僅適用於 teradata-logs 連接器。

範例：--query-log-start "2023-01-01 14:00:00"

要擷取查詢記錄的結束時間 (不含)。這個值會截斷至小時。這個旗標僅適用於 teradata-logs 連接器。

範例：--query-log-end "2023-01-15 22:00:00"

僅適用於 teradata 連接器。

限制從檢視畫面擷取的列數 TableSizeV。 資料列會依 DatabaseName、AccountName 和 TableName 欄分組，然後依永久空間大小 (運算式 SUM(CurrentPerm)) 遞減排序。接著，系統會擷取指定數量的資料列。

範例 (Bash)：
-Dteradata.metadata.tablesizev.max-rows=100000

範例 (Windows PowerShell)：
"-Dteradata.metadata.tablesizev.max-rows=100000"

僅適用於 teradata 連接器。

限制從檢視畫面擷取的列數 DiskSpaceV。 資料列會依永久空間大小 (CurrentPerm 欄) 遞減排序，然後擷取指定數量的資料列。

範例 (Bash)：
-Dteradata.metadata.diskspacev.max-rows=100000

範例 (Windows PowerShell)：
"-Dteradata.metadata.diskspacev.max-rows=100000"

僅適用於 teradata 連接器。

限制從檢視區塊 (DBKind='U') 擷取的使用者代表資料列數量 (DatabasesV)。系統會先依據「PermSpace」欄以遞減順序排序資料列，然後擷取指定數量的資料列。

範例 (Bash)：
-Dteradata.metadata.databasesv.users.max-rows=100000

範例 (Windows PowerShell)：
"-Dteradata.metadata.databasesv.users.max-rows=100000"

僅適用於 teradata 連接器。

限制代表資料庫的資料列數 (DBKind='D')，這些資料列是從檢視區塊 DatabasesV 擷取而來。系統會先依據「PermSpace」欄以遞減順序排序資料列，然後擷取指定數量的資料列。

範例 (Bash)：
-Dteradata.metadata.databasesv.dbs.max-rows=100000

範例 (Windows PowerShell)：
"-Dteradata.metadata.databasesv.dbs.max-rows=100000"

僅適用於 teradata 連接器。

從 TableTextV 檢視畫面擷取資料時，文字資料欄的長度上限。如果文字超過定義的上限，系統會將其分割為多列。允許的範圍：介於 5000 到 32000 (含)。

範例 (Bash)：
-Dteradata.metadata.max-text-length=10000

範例 (Windows PowerShell)：
"-Dteradata.metadata.max-text-length=10000"

僅適用於 teradata-logs 連接器。

DBQLSqlTbl.SqlTextInfo 欄的長度上限。 如果查詢文字超過定義的上限，系統會將其分成多列。允許的範圍：介於 5000 到 31000 (含)。

範例 (Bash)：
-Dteradata-logs.max-sql-length=10000

範例 (Windows PowerShell)：
"-Dteradata-logs.max-sql-length=10000"

在產生資料庫記錄或擷取中繼資料時開啟評估模式。 用於中繼資料擷取時，這項工具會產生 BigQuery 遷移評估所需的統計資料。用於擷取查詢記錄時，會產生 BigQuery 遷移評估的查詢指標統計資料。

要連線的資料庫名稱。

用於驗證的 AWS IAM 存取金鑰 ID。存取金鑰是由字元組成的字串，如下所示：AKIAIOSFODNN7EXAMPLE。

請與 --iam-secretaccesskey 旗標搭配使用。指定 --iam-profile 或 --password 旗標時，請勿使用這個旗標。

您不必明確提供驗證資訊，但必須透過下列任一方法提供：

• 請將這個旗標與 --iam-secretaccesskey 旗標搭配使用。
• 使用 --iam-profile 標記。
• 將 --password 旗標與 --user 旗標搭配使用。

用於驗證的 AWS IAM 設定檔。您可以檢查 $HOME/.aws/credentials 檔案或執行 aws configure list-profiles，擷取要使用的設定檔值。

請勿將此標記與 --iam-accesskeyid、--iam-secretaccesskey 或 --password 標記搭配使用。

您不必明確提供驗證資訊，但必須透過下列任一方法提供：

• 使用這個旗標。
• 一併使用 --iam-accesskeyid 和 --iam-secretaccesskey 旗標。
• 將 --password 旗標與 --user 旗標搭配使用。

用於驗證的 AWS IAM 私密存取金鑰。存取密鑰是由字元組成的字串，如下所示：wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY。

請與 --iam-accesskeyid 旗標搭配使用。請勿將此旗標與 --iam-profile 或 --password 旗標搭配使用。

您不必明確提供驗證資訊，但必須透過下列任一方法提供：

• 請將這個旗標與 --iam-accesskeyid 旗標搭配使用。
• 使用 --iam-profile 標記。
• 將 --password 旗標與 --user 旗標搭配使用。

請勿將此標記與 --iam-accesskeyid、--iam-secretaccesskey 或 --iam-profile 標記搭配使用。

您不必明確提供驗證資訊，但必須透過下列任一方法提供：

• 請將這個旗標與 --user 旗標搭配使用。
• 一併使用 --iam-accesskeyid 和 --iam-secretaccesskey 旗標。
• 使用 --password 標記。

要擷取查詢記錄的開始時間 (含此時間)。這個值會截斷至小時。這個旗標僅適用於 redshift-raw-logs 連接器。

範例：--query-log-start "2023-01-01 14:00:00"

要擷取查詢記錄的結束時間 (不含)。這個值會截斷至小時。這個旗標僅適用於 redshift-raw-logs 連接器。

範例：--query-log-end "2023-01-15 22:00:00"

在擷取中繼資料時開啟評估模式。 使用 dwh-migration-dumper 工具擷取中繼資料時，系統會產生 BigQuery 遷移評估所需的統計資料。

導致 dwh-migration-dumper 工具擷取分割區中繼資料。如果生產環境中繼存放區的分區數量龐大，您可能會想將這個旗標設為 false，因為這會影響 Thrift 用戶端效能。這項做法可提升擷取工具效能，但會導致 BigQuery 端的分割區最佳化作業有些許損失。

請勿將這個旗標與 --assessment 旗標搭配使用，否則不會有任何效果。

執行 dwh-migration-dumper 工具時，系統會根據這個旗標的值，選取適當的 Thrift 規格，用於與 Apache Hive 伺服器通訊。如果擷取工具沒有適當的 Thrift 規格，就會使用 2.3.6 版的用戶端，並向 stdout 發出警告。如果發生這種情況，請與支援團隊聯絡，並提供您要求的 Apache Hive 版本號碼。

RPC 保護設定等級。這會決定叢集與 dwh-migration-dumper 工具之間，簡單驗證與安全層 (SASL) 連線的保護品質 (QOP)。

必須等於叢集上 /etc/hadoop/conf/core-site.xml 檔案內的 hadoop.rpc.protection 參數值，且為下列其中一個值：

• authentication
• integrity
• privacy

範例 (Bash)：
-Dhiveql.rpc.protection=privacy

範例 (Windows PowerShell)：
"-Dhiveql.rpc.protection=privacy"

要連線的資料庫名稱。

要連線的資料庫名稱。

以半形逗號分隔的資料庫清單，列出要擷取的資料庫。

要連線的資料庫名稱。

連線要使用的 Oracle 服務名稱。

連線要使用的 Oracle 系統 ID (SID)。

資料庫連線要使用的使用者名稱。

您指定的使用者必須具備 SELECT_CATALOG_ROLE 角色，才能擷取中繼資料。如要查看使用者是否具備必要角色，請對 Oracle 資料庫執行 select granted_role from user_role_privs; 查詢。

要連線的資料庫名稱。

一次只能從 Snowflake 擷取一個資料庫的資料。

用於驗證的 RSA 私密金鑰路徑。建議您使用以金鑰配對為基礎進行驗證的SERVICE使用者。這樣一來，您就能安全地存取 Snowflake 資料平台，不必產生多重驗證權杖。

建立 RSA 私密金鑰時使用的密碼。

資料庫連線要使用的使用者名稱。

用於處理中繼資料查詢的 Snowflake 倉儲。

要連線的資料庫名稱。