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

在產生資料庫記錄或擷取中繼資料時，會啟用評估模式。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 連接器。

根據預設，系統會從 dbc.ResUsageScpu 資料表中擷取 SCPU 資源用量記錄。如果您需要從其他位置擷取這些資料，可以使用 -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 連接器。

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

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

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

僅適用於 teradata 連接器。

限制從檢視畫面 DatabasesV 擷取的資料庫 (DBKind='D') 列數。系統會依據 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 身分與存取權管理設定檔。您可以檢查 $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 工具擷取分區中繼資料。由於 Thrift 用戶端效能會受到影響，因此您可能會將此標記設為 false，以便為具有大量分區的實際用途元資料儲存庫使用。這麼做可改善擷取工具效能，但會導致 BigQuery 端的區隔最佳化功能有所損失。

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

執行 dwh-migration-dumper 工具時，系統會根據這個標記的值，選取用於與 Apache Hive 伺服器通訊的適當 Thrift 規格。如果擷取工具沒有適當的 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 倉儲。

要連線的資料庫名稱。