本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
使用逃生艙管理 Babelfish 錯誤處理
Babelfish 盡可能模仿 SQL 的控制流程和交易狀態行為。當 Babelfish 遇到錯誤時,會傳回類似 SQL Server 錯誤代碼的錯誤代碼。如果 Babelfish 無法將錯誤對應至 SQL Server 代碼,則會傳回固定的錯誤代碼 (33557097
),並會根據錯誤類型採取特定動作,如下所示:
-
針對編譯階段錯誤,Babelfish 會回復交易。
-
針對執行階段錯誤,Babelfish 會結束批次並回復交易。
-
對於用戶端和伺服器之間的通訊協定錯誤,不會回復交易。
如果錯誤代碼無法映射至同等代碼,但類似錯誤有可用代碼,則錯誤代碼會映射至替代碼。例如,造成 SQL Server 代碼 8143
和 8144
的行為都映射至 8143
。
無法映射的錯誤不遵守 TRY... CATCH
建構。
您可以使用 @@ERROR
來傳回 SQL Server 錯誤代碼,或使用 @@PGERROR
函數來使回 PostgreSQL 錯誤代碼。您也可以使用 fn_mapped_system_error_list
函數來傳回映射的錯誤代碼清單。如需 PostgreSQL 錯誤代碼的詳細資訊,請參閱 PostgreSQL 網站
修改 Babelfish 逃生艙設定
為了處理可能失敗的陳述式,Babelfish 定義幾個稱為逃生艙的選項。逃生艙選項指定 Babelfish 遇到不支援的功能或語法時採取的行為。
您可以使用 sp_babelfish_configure
預存程序來控制逃生艙的設定。使用指令碼將逃生艙設定為 ignore
或 strict
。如果設定為 strict
,Babelfish 會傳回錯誤,您必須更正才能繼續。
將變更套用至目前工作階段和叢集層級,包括 server
關鍵字。
用法如下:
若要列出所有逃生艙及狀態,還有使用資訊,請執行
sp_babelfish_configure
。若要列出目前工作階段或整個叢集的特定逃生艙及其值,請執行
sp_babelfish_configure '
命令,其中hatch_name
'
是一個或多個逃生艙的識別符。hatch_name
hatch_name
可以使用 SQL 萬用字元,例如 '%'。若要將一個或多個逃生艙設定為指定的值,請執行
sp_babelfish_configure ['
。若要讓設定永久存在於叢集全面層級上,請加上hatch_name
' [, 'strict'|'ignore' [, 'server']]server
關鍵字,如下所示:EXECUTE sp_babelfish_configure 'escape_hatch_unique_constraint', 'ignore', 'server'
若只要在目前工作階段中設定,請勿使用
server
。若要將所有逃生艙重設為其預設值,請執行
sp_babelfish_configure 'default'
(Babelfish 1.2.0 及更高版本)。
一個逃生艙 (或多個逃生艙) 的識別字串可包含 SQL 萬用字元。例如,以下將 Aurora PostgreSQL 叢集的所有語法逃生艙設定為 ignore
。
EXECUTE sp_babelfish_configure '%', 'ignore', 'server'
在下表中,您可以找到 Babelfish 預先定義逃生艙的說明和預設值。
逃生艙 | 描述 | 預設 |
---|---|---|
escape_hatch_checkpoint |
允許在程序碼中使用 CHECKPOINT 陳述式,但目前尚未實作 CHECKPOINT 陳述式。 |
ignore |
escape_hatch_constraint_name_for_default |
控制預設限制條件名稱相關的 Babelfish 行為。 |
ignore |
escape_hatch_database_misc_options |
在 CREATE 或 ALTER DATABASE 上控制下列選項相關的 Babelfish 行為:CONTAINMENT、DB_CHAINING、TRUSTWORTHY、PERSISTENT_LOG_BUFFER。 |
ignore |
escape_hatch_for_replication |
建立或更改資料表時,控制 [NOT] FOR REPLICATION 子句相關的 Babelfish 行為。 |
strict |
escape_hatch_fulltext |
控制 FULLTEXT 功能相關的 Babelfish 行為,例如 CREATE/ALTER DATABASE 中的 DEFAULT_FULLTEXT_LANGUAGE、CREATE FULLTEXT INDEX 或 sp_fulltext_database。 |
ignore |
escape_hatch_ignore_dup_key |
控制與 CREATE/ALTER TABLE 和 CREATE INDEX 相關的 Babelfish 行為。當 IGNORE_DUP_KEY=ON,如果設定為 |
strict |
escape_hatch_index_clustering |
控制索引及 PRIMARY KEY 或 UNIQUE 限制條件的 CLUSTERED 或 NONCLUSTERED 關鍵字相關的 Babelfish 行為。忽略 CLUSTERED 時,仍會視為已指定 NONCLUSTERED 來建立索引或限制條件。 |
ignore |
escape_hatch_index_columnstore |
控制 COLUMNSTORE 子句相關的 Babelfish 行為。如果指定 |
strict |
escape_hatch_join_hints |
控制 JOIN 運算子中的關鍵字行為:LOOP、HASH、MERGE、REMOTE、REDUCE、REDISTRIBUTE、REPLICATE。 |
ignore |
escape_hatch_language_non_english |
控制英文以外的螢幕訊息語言相關的 Babelfish 行為。Abelfish 目前僅支援 |
strict |
escape_hatch_login_hashed_password |
忽略時會抑制 |
strict |
escape_hatch_login_misc_options |
忽略時,除了 |
strict |
escape_hatch_login_old_password |
忽略時會抑制 |
strict |
escape_hatch_login_password_must_change |
忽略時會抑制 |
strict |
escape_hatch_login_password_unlock |
忽略時會抑制 |
strict |
escape_hatch_nocheck_add_constraint |
控制限制條件的 WITH CHECK 或 NOCHECK 子句相關的 Babelfish 行為。 |
strict |
escape_hatch_nocheck_existing_constraint |
控制 FOREIGN KEY 或 CHECK 限制條件相關的 Babelfish 行為。 |
strict |
escape_hatch_query_hints |
控制查詢提示相關的 Babelfish 行為。此選項設定為 ignore 時,對於使用 OPTION (...) 子句指定查詢處理事宜的提示,伺服器會忽略提示。例子包括 SELECT FROM ... OPTION(MERGE JOIN HASH, MAXRECURSION 10))。 |
ignore |
escape_hatch_rowversion |
控制 ROWVERSION 和 TIMESTAMP 資料類型的行為。如需使用方式的資訊,請參閱 使用具有限制實作的 Babelfish 功能。 |
strict |
escape_hatch_schemabinding_function |
控制 WITH SCHEMABINDING 子句相關的 Babelfish 行為。預設會忽略 CREATE 或 ALTER FUNCTION 命令中指定的 WITH SCHEMABINDING 子句。 |
ignore |
escape_hatch_schemabinding_procedure |
控制 WITH SCHEMABINDING 子句相關的 Babelfish 行為。預設會忽略 CREATE 或 ALTER PROCEDURE 命令中指定的 WITH SCHEMABINDING 子句。 |
ignore |
escape_hatch_rowguidcol_column |
建立或更改資料表時,控制 ROWGUIDCOL 子句相關的 Babelfish 行為。 |
strict |
escape_hatch_schemabinding_trigger |
控制 WITH SCHEMABINDING 子句相關的 Babelfish 行為。預設會忽略 CREATE 或 ALTER TRIGGER 命令中指定的 WITH SCHEMABINDING 子句。 |
ignore |
escape_hatch_schemabinding_view |
控制 WITH SCHEMABINDING 子句相關的 Babelfish 行為。預設會忽略 CREATE 或 ALTER VIEW 命令中指定的 WITH SCHEMABINDING 子句。 |
ignore |
escape_hatch_session_settings |
控制不支援的工作階段層級 SET 陳述式相關的 Babelfish 行為。 |
ignore |
escape_hatch_showplan_all |
控制與 SET SHOWPLAN_ALL 與 SET STATISTICS PROFILE 相關的 Babelfish 行為。當設定為 ignore 時,它們的行為類似於 SET BABELFISH_SHOWPLAN_ALL 和 SET BABELFISH_STATISTICS PROFILE;當設定為 strict 時,會無聲地將其忽略。 |
strict |
escape_hatch_storage_on_partition |
定義分割時控制 |
strict |
escape_hatch_storage_options |
CREATE、ALTER DATABASE、TABLE、INDEX 中使用的任何儲存選項上的逃生艙 這包括子句 (LOG) ON、TEXTIMGE_ON、FILESTREAM_ON,用於定義資料表、索引、限制條件及資料庫的儲存位置 (分割區、檔案群組)。此逃生艙設定套用至以上所有子句 (包括 ON [PRIMARY] 和 ON "DEFAULT")。但以 ON partition_scheme (column) 指定資料表或索引的分割區時例外。 |
ignore |
escape_hatch_table_hints |
控制使用 WITH (...) 子句指定的資料表提示的行為。 |
ignore |
escape_hatch_unique_constraint |
設定為嚴格時,SQL Server 和 PostgreSQL 在處理索引欄上的 NULL 值方面的模糊語義差異可能會引發錯誤。語義差異只會出現於不切實際的使用案例中,因此您可將此轉義剖面設定為「忽略」以避免看到錯誤。 |
strict |