共用方式為

管理 Lakehouse 同盟的連線

  • 發行項

本文說明如何在筆記本或 Databricks SQL 查詢編輯器中使用目錄總管和 SQL 語句，列出 Unity 目錄中繼存放區中定義的所有 Lakehouse 同盟連線、取得連線詳細數據、授與連線許可權，以及卸除連線。 連接 是 Unity Catalog 中一個可安全管理的物件，用於設定存取外部資料庫系統的路徑和憑證。

另 請參閱建立連線。

如果您想要使用 REST API，請參閱 Azure Databricks 參考檔。

列出連線

所需的許可權：傳回的連接清單取決於您的角色和許可權。 具有中繼存放區 USE CONNECTION 許可權的使用者會看到所有連線。 否則，您只能檢視那些您作為連接物件擁有者或擁有某些訪問許可權的連線。

目錄瀏覽器

  1. 在 Azure Databricks 工作區中，按一下 目錄圖示目錄。

  2. 在 [目錄] 窗格頂端，單擊 [齒輪] 圖示 齒輪圖示，然後從功能表中選取 [連線]。

    或者，從 [快速存取] 頁面，按兩下 [外部數據 >] 按鈕，然後移至 [連線] 索引標籤。

    您有權查看的連接會列出，以及URL、建立日期、擁有者和批注。

SQL

在筆記本或 Databricks SQL 查詢編輯器中執行下列命令。 可選地，將 <pattern> 替換為 LIKE 述詞。

SHOW CONNECTIONS [LIKE <pattern>];

取得連線詳細數據

需要的許可權：連線擁有者、中繼存放區的相關許可權，或對連線的某些權限。

目錄瀏覽器

  1. 在 Azure Databricks 工作區中，按一下 目錄圖示目錄。

  2. 在 [目錄] 窗格頂端，單擊 [齒輪] 圖示 齒輪圖示，然後從功能表中選取 [連線]。

    或者，從 [快速存取] 頁面，按兩下 [外部數據 >] 按鈕，然後移至 [連線] 索引標籤。

  3. 尋找連線，然後選取它以檢視詳細數據。

SQL

在筆記本或 Databricks SQL 查詢編輯器中執行下列命令。

DESCRIBE CONNECTION <connection-name>;

授與和撤銷連線的許可權

您可以授與權限以使用連線來建立外部目錄，或檢視連線的詳細資料：

  • CREATE FOREIGN CATALOG 能夠將外來目錄建立為連接所描述數據源中資料庫的唯讀鏡像。
  • USE CONNECTION 授予您使用 DLT 的連接功能，將數據從數據源載入到 Azure Databricks 的能力。 不過，如果在元儲存區層級授權，它只允許查看元儲存區中連接的詳細信息。 使用者仍必須被授予USE CONNECTION的個別連線權限才能使用它們。

需要的許可權：Metastore 管理員或連接擁有者。

目錄瀏覽器

若要授予使用連線的許可權：

  1. 在 Azure Databricks 工作區中，按一下 目錄圖示目錄。

  2. 在 [目錄] 窗格頂端，單擊 [齒輪] 圖示 齒輪圖示，然後從功能表中選取 [連線]。

    或者，從 [快速存取] 頁面，按兩下 [外部數據 >] 按鈕，然後移至 [連線] 索引標籤。

  3. 找到連線並進行選擇。

  4. 在 許可權 索引標籤上，按一下 授與。

  5. 在 [授與 <connection-name>] 對話框中，開始輸入使用者或組名，或按兩下使用者選單來瀏覽並選取使用者和群組。

  6. 選取您想要授與的許可權。

    請參閱簡介一節中的許可權描述。

  7. 按一下 [授與]。

若要撤銷連線許可權：

  1. 請遵循上述步驟來取得連線 許可權 索引標籤。
  2. 選取您要撤銷其許可權的使用者或群組。
  3. 在索引標籤和確認對話框中，按兩下 [撤銷]。

SQL

若要授與使用連線建立外部目錄的能力，請在筆記本或 Databricks SQL 查詢編輯器中執行下列命令。

GRANT CREATE FOREIGN CATALOG ON CONNECTION <connection-name> TO <user-name>;

若要授與檢視連線的能力，請執行下列命令：

GRANT USE CONNECTION ON CONNECTION <connection-name> TO <user-name>;

若要撤銷許可權，請執行下列命令，其中 <privilege> 是授與用戶連線的其中一個許可權：

REVOKE <privilege> ON CONNECTION <connection-name> FROM <user-name>;

卸除連線

所需許可權：連線擁有者

目錄瀏覽器

  1. 在 Azure Databricks 工作區中，按一下 目錄圖示目錄。

  2. 在 [目錄] 窗格頂端，單擊 [齒輪] 圖示 齒輪圖示，然後從功能表中選取 [連線]。

    或者，從 [快速存取] 頁面，按兩下 [外部數據 >] 按鈕，然後移至 [連線] 索引標籤。

  3. 找到連線並進行選擇。

  4. 按下 kebab 選單 kebab 選單，然後選取 [刪除]。

  5. 在確認對話框中，按兩下 [ 刪除]。

SQL

在筆記本或 Databricks SQL 查詢編輯器中執行下列命令。

DROP CONNECTION [IF EXISTS] <connection-name>;