同步資料表流程使用者錯誤。
ACCELERATED_SYNC_DATA_TOO_LARGE
同步資料表 <tableName> 有太多大欄位值，無法使用加速同步。
對於新的同步表格，從 UI 建立時請關閉加速同步。
若有已同步的資料表，請聯絡 Azure Databricks 支援。
ACTIVE_ENDPOINTS_LIMIT
實例： <instance>。 資料庫專案已超過同時啟用端點的上限，因此同步資料表管線無法連線。 細節： <detail>。
為了解決這個問題，請減少同時啟用端點的數量，或提高專案的上限。
ACTIVE_TIME_QUOTA_EXCEEDED
實例： <instance>。 資料庫專案已超過其有效時間配額，因此同步資料表管線無法連線。 細節： <detail>。
為了解決這個問題，請增加你專案的有效時間配額。
BRANCH_COMPUTE_TIME_EXCEEDED
實例： <instance>。 資料庫分支已超過計算時間，因此同步的表格管線無法連接。 細節： <detail>。
為了解決這個問題，請增加該分支可用的運算時間。
CHANGED_PRIMARY_KEY
同步資料表 <destTableUcName> 中指定的主要鍵欄位已被更改。
指定的主要鍵欄位：（<primaryKeyColumns>）。 目前主要鍵欄位：（<existingPrimaryKeyColumns>）。
在同步資料表建立後，不支援更改主鍵欄位。
要解決這個問題，可以將同步的資料表改回原本的主鍵欄位，或建立新的同步資料表並刪除現有的。
CHANGED_PRIMARY_KEY_COLUMN_TYPE
同步表格<modifiedPkColumns>中主鍵欄位<destTableUcName>的資料型態已更改。
在建立同步資料表後，不支援更改主鍵欄位的資料型態。
為了解決這個問題，請建立一個新的同步資料表，然後把現有的那個丟掉。
字元不在字集內
實例： <instance>。 在來源 Delta 資料表中找到無效的位元組序列。
細節： <detail>
這通常表示來源 Delta 資料表包含無效字元。
與目標資料庫的編碼相容。 一種因應措施是將
原始資料表使用 BINARY TYPE，接著建立新的同步資料表。
不支援變更欄位類型
實例： <instance>。 目前不支援變更數據行類型。
來源差異數據表： <srcTableName>。 目的地同步數據表： <destTableName>。
列：<columnName>。 現有類型： <existingType>。 新類型： <newType>。
若要解決此問題，請考慮下列其中一個選項：
執行現有同步數據表的完整重新整理。
建立新的同步資料表（自動支援新的類型）
COMPUTE_TIME_QUOTA_EXCEEDED
實例： <instance>。 資料庫帳號或專案已超過其計算時間配額，因此同步的資料表管線無法連接。 細節： <detail>。
為了解決這個問題，請增加你帳戶或專案的運算時間配額。
連線錯誤
實例： <instance>。 連線錯誤。 細節： <detail>。
若要解決此問題，請確保資料庫執行個體正在執行，而不是暫停或停止。
重新啟動管線以重試。
資料庫不存在
目的資料庫 <databaseName> 在 lakebase 實例 <instance>中不存在。 請確認目的地資料庫是否存在。
DATABASE_ROLE_NOT_EXIST
實例： <instance>。 同步表格管線所依賴的 Postgres 角色 <roleName> 並不存在。 細節： <detail>。
這通常發生在角色從資料庫實例中刪除時，例如在身份從工作區移除後。
要解決這個問題，可以在資料庫實例上重新建立 Postgres 角色 <roleName> ，或是丟棄並用仍存在的身份來建立同步的資料表。
DATA_TRANSFER_QUOTA_EXCEEDED
實例： <instance>。 資料庫專案已超過資料傳輸配額，因此同步資料表管線無法連線。 細節： <detail>。
為了解決這個問題，請增加你專案的資料傳輸配額。
DELTA_TRUNCATED_TRANSACTION_LOG
細節： <detail>。
這表示 delta 資料表的交易日誌因手動刪除或日誌保留政策而被截斷。
要解決這個問題，請對同步資料表進行完整刷新。
依賴物件仍存在
實例： <instance>。 無法刪除欄位，因為已有
PostgreSQL 物件仍然指向欄位。 細節： <detail>。
若要解決此問題，請考慮下列其中一個選項：
將缺失的欄位以與先前相同的資料型態重新加入來源資料表。
把相依物件丟到 PostgreSQL 裡。
DESTINATION_NAME_NOT_A_TABLE
實例： <instance>。 無法建立同步資料表 <destTableUcName> ，因為其目的名稱已被目標資料庫中的 a <objectType> 使用。
同步資料表管線不會建立或管理這個物件。
刪除或重新命名現有 <objectType>的資料表，或用不同名稱建立同步資料表，然後再嘗試。
DESTINATION_SCHEMA_ACCESS_ERROR
實例： <instance>。 同步資料表管線對目的結構 <schemaName>沒有權限。 細節： <detail>。
管線以 Postgres 角色連接，該角色 <databaseUser>需要 USAGE 和 CREATE 在目的結構上建立並維護目標資料表。
要解決此問題，請執行： GRANT USAGE, CREATE ON SCHEMA <quotedSchemaName> TO <quotedDatabaseUser>;然後重新啟動管線。
DUPLICATE_PRIMARY_KEY_COLUMNS
<duplicatedPkColumns>欄位在同步資料表<destTableUcName>的主鍵中多次指定。
為了解決這個問題，請將主鍵中的重複欄位移除，讓每個欄位只出現一次。
ENDPOINT_DISABLED
實例： <instance>。 目標資料庫實例已被停用，無法接受連線。 細節： <detail>。
這通常發生在實例被停止時。 被停用的實例無法透過連線嘗試啟動。
要解決這個問題，請重新啟動或啟動資料庫實例，然後重新啟動管線。
如果實例是故意停止，請暫停或刪除同步的表格。
ENDPOINT_NOT_FOUND
實例： <instance>。 找不到目標資料庫端點或無法存取。 細節： <detail>。
為了解決這個問題，請確認資料庫實例是否存在，且同步資料表是否已設定為正確的實例。
外鍵約束違規
實例： <instance>。 與來源資料表同步時的外鍵限制違規：
<srcTableName>。 細節： <detail>
不支援建立參考同步表的外鍵約束。 請
移除外鍵限制，重新嘗試同步。
指標行大小超出 (INDEX_ROW_SIZE_EXCEEDED)
實例： <instance>。 來源 Delta 表 <srcTableName> 中的主鍵值過大，無法滿足需求。
PostgreSQL 的 B 樹索引。 PostgreSQL 將所有主鍵的索引條目限制在約 2704 位元組
欄位合併。 細節： <detail>。
為了解決這個問題，請縮小主鍵欄位中儲存的資料大小，或減少使用的主鍵欄位數量。
較短的主鍵欄位。
實例空間不足
由於資料庫大小，無法將資料表 <tableName> 同步到實例 <instance> 中。
目前實例使用量： <instanceSize> 位元組。
預估未壓縮資料表大小： <estimatedLoadSize> 位元組。
實例大小限制： <maxInstanceSize> 位元組。
請減少同步所需的資料量，或在實例中移除一些現有資料表以釋放空間。
INVALID_ENDPOINT
實例： <instance>。 資料庫實例拒絕了該連線，因為請求的端點不適合此操作。 細節： <detail>。
當不允許唯讀連線，或請求的運算不存在時，這種情況就可能發生。
要解決這個問題，請驗證同步資料表的目標實例與端點設定，然後重新啟動管線。
無效的表名稱
無效資料表名稱 <tableName>：預期為三部分名稱（catalog.schema.table）。
INVALID_TYPE_OVERRIDE
實例： <instance>。 欄位的類型覆寫 <columnName>無效： <reason>。
INVALID_VECTOR_DATA
欄位的向量資料 <columnName>無效： <reason>。
IP_NOT_ALLOWED
實例： <instance>。 同步資料表管線的 IP 位址不允許連接到資料庫實例。 細節： <detail>。
為了解決這個問題，請更新資料庫實例的 IP 允許清單以允許連線。
LOCK_TIMEOUT
實例： <instance>。 資料庫： <databaseName>。 同步表管線無法在設定的逾時 (<timeoutSeconds> 秒) 內取得鎖定。
偵測到 <numBlockingTransactions> 筆交易持有鎖在目標資料表上（最大鎖保留時間：<lockDurationSeconds> 秒）。
使用者交易持有鎖，阻擋同步資料表管線更新目標資料表。
欲了解更多有關錯誤交易的資訊，請查閱 Spark 驅動程式日誌（搜尋「[LOCK TIMEOUT DIAGNOSTICS]'）。
為了解決這個問題，請使用 pg_stat_activity 找到 postgres 實例中有長期執行交易的連線，並關閉這些交易（如果連線不再需要，也可以用 pg_terminate_backend 終止連線）。
為了防止此問題再次發生，請考慮以下選項：
確保您的應用程序要么提交交易，要么回滚交易。
避免長期交易。 如果應用程式裡的工作不需要在交易中完成，請將auto_commit設為開啟。
在資料庫中設置參數 idle_in_transaction_session_timeout 以自動終止那些閒置的交易。
範例： ALTER DATABASE <databaseName> SET idle_in_transaction_session_timeout = 「5分鐘」;
LOGICAL_SIZE_QUOTA_EXCEEDED
實例： <instance>。 資料庫專案已超過其邏輯容量配額，因此同步資料表管線無法連接。 細節： <detail>。
為了解決這個問題，請增加專案的邏輯大小配額或減少儲存的資料量。
MIS_CONFIGURED_PRIMARY_KEY (主鍵配置錯誤)
來源 Delta 表格所提供的主鍵： <srcTableName> 在原始碼表格中無法取得。
主鍵： <primaryKeys>。 可用欄位： <availableColumns>。 缺少主鍵： <missingPkColumns>。
若要解決此問題，請考慮下列其中一個選項：
將缺失的欄位加入來源資料表。
建立一個新的同步表格，並設定正確的主鍵設定。
NATIVE_LOGIN_BLOCKED
實例： <instance>。 同步資料表管線所用的資料庫角色禁用了原生（密碼）登入功能。 細節： <detail>。
要解決此問題，請啟用管線資料庫角色的原生登入，或重新設定角色以使用支援的認證方法。
NETWORK_BLOCKED
實例： <instance>。 同步資料表管線不允許從其網路連接到資料庫實例。 細節： <detail>。
為了解決這個問題，請更新資料庫實例的網路存取設定以允許連線。
PERMISSION_DENIED
細節： <detail>。
請確認您是否擁有足夠的權限。
PIPELINE_ROLE_NOT_EXIST（管道角色不存在）
實例： <instance>。 同步資料表管線的資料庫編譯器角色缺失。 細節： <detail>。
這通常發生在目標資料庫被刪除時，因為這會移除管線的寫入角色。
要解決這個問題，請確認目標資料庫是否存在且沒有被丟棄。
如果資料庫是被故意刪除，請刪除同步表，然後在資料庫重新建立後重新建立該表。
PRIMARY_KEY_CONSTRAINT_VIOLATION
實例： <instance>。 根據主鍵偵測到重複的數據列。 細節： <detail>
這表示主鍵數據行的設定錯誤。
請確認您使用的是正確的主鍵集合
來自來源 Delta 表格： <srcTableName>。
若要解決此問題，請建立一個新的同步表格並使用正確的
主鍵組態。
QUOTA_EXCEEDED
實例： <instance>。 目標資料庫帳號或專案已超過其配額。 細節： <detail>。
為了解決這個問題，請降低使用量或升級計畫以增加配額，然後重新啟動管線。
REFRESH_WITH_FOREIGN_KEY（重新整理具外鍵）
實例： <instance>。 無法重新整理同步的資料表<destTableName> 因為該表格
<childTableName> 有一個外鍵約束，指向同步表。
當有外鍵限制時，不支援重新整理同步表
引用它。 請移除外鍵限制並重新嘗試刷新。
REQUIRED_EXTENSION_NOT_INSTALLED
實例： <instance>。 未安裝所需的 PostgreSQL 擴充功能 '<extension>'。 在建立這個同步之前，先在 Lakebase 實例上安裝它。
SCHEMA_BUILDER_NOT_ENABLED
此工作區未啟用同步資料表結構自訂<features>（）功能。
SCHEMA_不存在
細節： <detail>。
請確認該結構是否存在於 Unity 目錄中。
原始資料讀取錯誤
無法讀取來源表 <tableName>。 請確認是否能透過 SELECT 查詢成功讀取來源資料表。
細節： <detail>
SOURCE_SMART_CLONE_REQUIRED
原始資料化檢視 <srcTableName> 必須啟用 SmartClone 才能用作同步資料表原始碼。 跑去 REPAIR TABLE <srcTableName> SYNC METADATA 再試一次。
SPARK_JOB_CANCELLED
Spark 作業已取消。
細節： <detail>
SYSTEM_COLUMN_NAME_CONFLICT
實例： <instance>。 來源 Delta 資料表 <srcTableName> 包含一個欄位，其名稱與 PostgreSQL 系統欄位名稱衝突。 細節： <detail>。
PostgreSQL 保留某些欄位名稱（如 xmin、xmax、ctid、cmin、cmax、tableoid）供內部使用。
要解決此問題，請重新命名來源 Delta 資料表中衝突的欄位，並重新建立同步資料表。
或者建立一個排除衝突欄位的視圖，然後改為同步該視圖。
SYSTEM_SCHEMA_ACCESS_ERROR
實例： <instance>。 內部系統架構（__db_system）無法被同步表管線存取。 細節： <detail>。
這可能是因為資料庫被重置，或內部結構在未取得適當權限的情況下被丟棄並重新建立。
為了解決這個問題，請丟棄並重新建立同步的資料表 <destTableUcName>。
表格不存在
細節： <detail>。
請確認同步的資料表是否存在於 Unity 目錄中。
TARGET_DATABASE_FULL
目標資料庫 <databaseName> 空間已滿。 無法繼續攝取。
連線過多
資料庫實例的連線過多： <instance>
細節： <detail>。
每次資料表同步最多可使用16個連接至資料庫實例，這些連線計入實例的連線上限。
要解決這個問題，請嘗試以下選項：
- 減少同時寫入同一資料庫實例的管線數量。
例如，錯開管道排程。
- 減少來自其他工作負載連接同一資料庫實例的同時連線數量。
不支援的欄位類型
實例： <instance>。 不支援的 PostgreSQL 欄位類型： <columnType>。
UNTRANSLATABLE_CHARACTER
實例： <instance>。 在源 Delta 表中發現無法翻譯的字元。
細節： <detail>
這通常表示來源 Delta 資料表包含無效字元。
與目標資料庫的編碼相容。 一種因應措施是將
原始資料表使用 BINARY TYPE，接著建立新的同步資料表。
VPC_ENDPOINT_NOT_ALLOWED
實例： <instance>。 同步資料表管線的 VPC 端點不允許連接到資料庫實例。 細節： <detail>。
為了解決這個問題，請將 VPC 端點加入資料庫實例的允許清單。
WRITTEN_DATA_QUOTA_EXCEEDED
實例： <instance>。 資料庫專案已超過其書面資料配額，因此同步資料表管線無法連線。 細節： <detail>。
為了解決這個問題，請增加專案的書面資料配額。