對應要翻譯的 SQL 物件名稱

名稱對應功能可讓您使用 YAML 設定檔,將來源檔案中的 SQL 物件名稱對應至 BigQuery 中的目標名稱。在 SQL 翻譯期間,SQL 陳述式中對每個來源名稱的所有參照,都會更新為翻譯輸出內容中的目標名稱。

您可以使用下列部分或所有元件,為物件設定名稱對應:

  • 名稱對應規則,包含:
    • 來源名稱部分:提供來源系統中物件的完整名稱。
    • 提供 BigQuery 物件名稱的目標名稱部分。
  • 「預設資料庫」名稱,用於未指定資料庫名稱的來源物件。
  • 預設結構定義名稱,用於未指定結構定義的來源物件。

名稱部分

您可以使用下列名稱部分的組合,在名稱對應規則中提供來源和目標物件名稱的值:

  • Database:物件階層中的頂層物件,例如 database.schema.relation.attribute。來源平台可能會使用其他字詞,例如「專案」。
  • Schema:物件階層中的第二層物件。來源平台可能會使用其他字詞,例如「資料集」。
  • Relation:物件階層中的第三層物件。來源平台可能會使用其他字詞,例如「table」(表格) 或「view」(檢視畫面)。
  • Function:物件階層中的第三層物件,代表使用者定義函式或預存程序,例如 create procedure db.test.function1(a int)。
  • Attribute:物件階層中的第四層物件。來源平台可能會使用其他字詞,例如「欄」。

在設定 YAML 檔案中設定名稱對應規則時,只需加入要變更的目標名稱部分。任何省略的目標名稱部分都會保持不變。

預設資料庫

如要將 BigQuery 專案名稱附加至所有翻譯物件,最簡單的方法是在設定 YAML 檔案中指定預設資料庫名稱。這適用於使用三部分命名法的來源檔案,或使用四部分命名法但未指定最高層級物件名稱的來源檔案。

舉例來說,如果您指定預設資料庫名稱 myproject,則 SELECT * FROM database.table 等來源陳述式會轉譯為 SELECT * FROM myproject.database.table。如果物件已使用資料庫名稱部分 (例如 SELECT * FROM database.schema.table),則必須使用名稱對應規則,將 database.schema.table 重新命名為 myproject.schema.table。

預設結構定義

如要完整限定來源檔案中所有未使用四部分命名的物件名稱,可以在設定 YAML 檔案中,同時提供預設資料庫名稱和預設結構定義名稱。預設結構定義名稱會做為結構定義搜尋路徑選項中的第一個結構定義名稱。

舉例來說,如果您指定預設資料庫名稱 myproject 和預設結構定義名稱 myschema,則下列來源陳述式:

  • SELECT * FROM database.table
  • SELECT * FROM table1

會翻譯成:

  • SELECT * FROM myproject.database.table。
  • SELECT * FROM myproject.myschema.table1

名稱對應規則行為

以下各節說明名稱對應規則的運作方式。

規則繼承會沿著物件階層向下流動

如果名稱變更會影響較高層級的物件,則會影響目標物件,以及同一階層中的所有子物件。

舉例來說,如果您指定下列名稱對應規則,且物件類型為 schema:

名稱部分 來源 目標
資料庫 sales_db sales
結構定義 cust_mgmt cms
關係
屬性

套用後,sales_db.cust_mgmt 結構定義下所有 relation 和 attribute 物件的資料庫和結構定義名稱部分也會變更。舉例來說,名為 sales_db.cust_mgmt.history 的 relation 物件會變成 sales.cms.history。

相反地,如果變更名稱的目標是較低層級的物件,則不會影響物件階層中較高或相同層級的物件。

舉例來說,如果您指定下列名稱對應規則,且物件類型為 relation:

名稱部分 來源 目標
資料庫 sales_db sales
結構定義 cust_mgmt cms
關係 clients accounts
屬性

套用後,物件階層中 sales_db 或 sales_db.cust_mgmt 層級的其他物件都不會變更名稱。

系統會套用最明確的規則

一個物件只能套用一項名稱對應規則。如果有多項規則可能影響單一物件,系統會套用影響最低層級名稱部分的規則。舉例來說,如果 database 類型名稱對應規則和 schema 類型名稱對應規則都可能影響 relation 物件的名稱,則會套用 schema 類型名稱對應規則。

請使用不重複的類型和來源值組合

您無法指定多個類型和來源值相同的名稱對應規則。舉例來說,您無法同時指定下列兩項名稱對應規則:

規則 1,類型 attribute 規則 2,類型 attribute
名稱部分 來源 目標 來源 目標
資料庫 project project
結構定義 dataset1 dataset1
關係 table1 table1
屬性 lname last_name lname lastname

名稱變更不會連帶影響

名稱變更不會套用到所有名稱規則。舉例來說,如果您建立一項名稱對應規則,將 database1 重新命名為 project1,並建立另一項規則,將 project1 重新命名為 project2,翻譯工具不會將 database1 對應至 project2。

處理沒有四部分名稱的來源物件

部分來源系統 (例如 Teradata) 會使用三個名稱部分,完整限定物件名稱。許多來源系統也允許您在 SQL 方言中使用部分限定名稱,例如使用 database1.schema1.table1、schema1.table1 和 table1 在不同情境中參照同一個物件。如果來源檔案包含未使用四部分物件名稱的物件,您可以搭配使用名稱對應和指定預設資料庫名稱和預設結構定義名稱,以達到所需的名稱對應。

如需使用名稱對應規則搭配預設資料庫名稱或預設結構定義名稱的範例,請參閱「針對名稱完整程度不同的物件,變更資料庫名稱部分」和「變更部分限定的關係物件名稱」。

名稱對應範例

請參閱本節範例,瞭解名稱對應規則在常見用途中的運作方式。如需 YAML 設定語法和範例,請參閱「輸出名稱對應」。

變更完整物件的資料庫名稱部分

以下範例會將所有具有完整名稱的 database、schema、relation 和 function 物件,其資料庫名稱部分從 td_project 重新命名為 bq_project。

來源和目標名稱部分

名稱部分 來源 目標
資料庫 td_project bq_project
結構定義
關係
屬性

類型

  • database

輸入內容範例

  • SELECT * FROM td_project.schema.table;
  • SELECT * FROM td_project.schema1.table1;

輸出內容範例

  • SELECT * FROM bq_project.schema.table;
  • SELECT * FROM bq_project.schema1.table1

變更名稱完整度不同的物件資料庫名稱部分

以下範例會將所有物件類型的資料庫名稱部分 project 重新命名為 bq_project,並為未指定資料庫名稱部分的物件新增 bq_project。

如要這麼做,除了指定名稱對應規則外,還必須指定預設資料庫值。如要進一步瞭解如何指定預設資料庫名稱,請參閱「指定預設資料庫和結構定義搜尋路徑」。

預設資料庫值

  • project

來源和目標名稱部分

名稱部分 來源 目標
資料庫 project bq_project
結構定義
關係
屬性

類型

  • database

輸入內容範例

  • SELECT * FROM project.schema.table;
  • SELECT * FROM schema1.table1;

輸出內容範例

  • SELECT * FROM bq_project.schema.table;
  • SELECT * FROM bq_project.schema1.table1

變更完整限定物件的資料庫名稱和結構定義名稱部分

以下範例會將資料庫名稱部分 warehouse1 變更為 myproject,並將 database1 結構定義名稱部分變更為 mydataset。

您也可以使用 relation 類型,並指定關係名稱部分的來源和目標值,以相同方式變更 relation 物件名稱的部分。

來源和目標名稱部分

名稱部分 來源 目標
資料庫 warehouse1 myproject
結構定義 database1 mydataset
關係
屬性

類型

  • schema

輸入內容範例

  • SELECT * FROM warehouse1.database1.table1;
  • SELECT * FROM database2.table2;

輸出內容範例

  • SELECT * FROM myproject.mydataset.table1;
  • SELECT * FROM __DEFAULT_DATABASE__.database2.table2;

變更完整的 relation 物件名稱

以下範例會將 mydb.myschema.mytable 重新命名為 mydb.myschema.table1。

來源和目標名稱部分

名稱部分 來源 目標
資料庫 mydb mydb
結構定義 myschema myschema
關係 mytable table1
屬性

類型

  • relation

輸入內容範例

  • CREATE table mydb.myschema.mytable(id int, name varchar(64));

輸出內容範例

  • CREATE table mydb.myschema.table1(id integer, name string(64));

變更部分限定的 relation 物件名稱

以下範例會將 myschema.mytable 重新命名為 mydb.myschema.table1。

預設資料庫值

  • mydb

來源和目標名稱部分

名稱部分 來源 目標
資料庫 mydb mydb
結構定義 myschema myschema
關係 mytable table1
屬性

類型

  • relation

輸入內容範例

  • CREATE table myschema.mytable(id int, name varchar(64));

輸出內容範例

  • CREATE table mydb.myschema.table1(id integer, name string(64));

變更 function 物件名稱

以下範例會將 mydb.myschema.myprocedure 重新命名為 mydb.myschema.procedure1。

來源和目標名稱部分

名稱部分 來源 目標
資料庫 mydb mydb
結構定義 myschema myschema
函式 myprocedure procedure1
屬性

類型

  • function

輸入內容範例

  • CREATE PROCEDURE mydb.myschema.myprocedure(a int) BEGIN declare i int; SET i = a + 1; END;
  • CALL mydb.myschema.myprocedure(7)

輸出內容範例

  • CREATE PROCEDURE mydb.myschema.procedure1(a int) BEGIN declare i int; SET i = a + 1; END;
  • CALL mydb.myschema.procedure1(7);

變更 attribute 物件名稱

以下範例會將 mydb.myschema.mytable.myfield 重新命名為 mydb.myschema.mytable.field1。由於 attribute 物件位於物件階層的最底層,因此這項名稱對應不會變更任何其他物件的名稱。

來源和目標名稱部分

名稱部分 來源 目標
資料庫 mydb
結構定義 myschema
關係 mytable
屬性 myfield field1

類型

  • attribute

輸入內容範例

  • CREATE table mydb.myschema.mytable(myfield int, name varchar(64), revenue int);
  • SELECT myfield, name FROM mydb.myschema.mytable;

輸出內容範例

  • CREATE table mydb.myschema.mytable(field1 int, name varchar(64), revenue int);
  • SELECT field1, name FROM mydb.myschema.mytable;