前提條件

• 已購買Hologres實例并創建數據庫。操作詳情請參見購買Hologres、創建數據庫。

  說明

  建議購買Hologres實例時，地域與創建Hologres數據源的DataWorks工作空間地域一致，如果地域不一致就只能創建為跨地域的數據源，此類數據源無法在DataWorks的數據開發（DataStudio）模塊綁定，即無法在DataWorks的數據開發、運維中心頁面中執行對應計算任務，僅可進行數據同步任務。

• 已購買所需的資源組并完成資源組配置。

  數據源創建完成后，可用于數據同步、Hologres計算任務開發與調度、生成API提供數據服務等場景。新版通用型資源組（推薦）僅一個資源組即可滿足上述所有場景的應用；舊版獨享資源組需根據使用場景（用于數據集成、調度或數據服務）選擇相應類型資源組購買。請提前準備好相應資源組并完成資源組配置，確保創建數據源時可與資源組網絡連通。資源組相關操作請參見資源組管理。

  說明

  Hologres實例僅支持使用新版資源組及舊版獨享資源組。

• 已創建或加入目標工作空間。

  您需在目標工作空間中，將Hologres實例創建為該工作空間的數據源，用于后續在該工作空間進行開發操作。同時，需將購買的DataWorks資源組綁定至該工作空間，確保數據源與資源組網絡連通。創建工作空間，詳情請參見創建并管理工作空間。

  說明

  同一個Hologres實例可在多個DataWorks工作空間中被創建為數據源。

使用限制

• 僅當Hologres實例和DataWorks工作空間同地域、同阿里云主賬號，且基于此實例創建的數據源未開啟SSL認證，該數據源才可用于數據開發和調度。

  重要

  若訪問Hologres實例時需要加密傳輸，則您可在創建數據源時開啟SSL認證，但開啟認證后，該數據源將無法用于數據開發和調度。

• 跨賬號創建的數據源（即將其他阿里云賬號的Hologres實例創建為當前賬號下的數據源），僅支持通過RAM角色的方式訪問對應Hologres實例，并且該數據源不能用于數據開發和調度。

• 僅支持使用新版資源組及舊版獨享資源組運行Hologres相關任務。詳情請參見新增和使用Serverless資源組、使用舊版資源組。

操作前準備：權限說明與配置

1. DataWorks側權限配置。

   創建數據源之前，請確保操作的阿里云賬號有DataWorks數據源的新建權限。滿足下列條件之一即可：

   • 操作賬號是阿里云主賬號。

   • 操作賬號是RAM賬號或RAM角色，且擁有AliyunDataWorksFullAccess權限。詳情請參見為RAM用戶授權、為RAM角色授權。

   • 操作賬號是RAM賬號或RAM角色，且擁有DataWorks工作空間的項目所有者、運維或空間管理員角色，詳情請參見添加空間成員并管理成員角色權限。

   說明

   若操作賬號（即當前登錄賬號）為RAM賬號，則創建數據源時，平臺會根據您選擇的默認訪問身份，判斷該賬號是否還需具備其他權限，具體如下：

   • 若數據源的默認訪問身份設置為執行者，則無需再添加額外的權限。

   • 若數據源的默認訪問身份設置為阿里云主賬號、阿里云RAM角色（非操作角色）、阿里云RAM子賬號（非操作賬號），則當前操作賬號需具備AdministratorAccess權限。

2. Hologres側權限配置。

   在數據源創建完成后，需要使用數據源配置的訪問身份來訪問對應的Hologres實例，因此，您需確保訪問身份對應的阿里云賬號有Hologres實例的操作權限。Hologres權限說明詳情級授權指導請參見Hologres權限模型概述。

3. （可選）跨賬號場景下的權限配置。（單擊展開查看詳情）

   跨阿里云賬號創建Hologres數據源時，僅支持通過RAM角色訪問的方式訪問對應的Hologres實例，且需要對對應的RAM角色配置以下權限策略。

   • 跨賬號創建數據源場景示例：

     本文示例使用主賬號A登錄DataWorks，通過主賬號B的Hologres實例創建Hologres數據源，實現數據源的跨賬號創建。

     • 主賬號A：開通了DataWorks，需訪問主賬號B下的Hologres。

     • 主賬號B：已開通Hologres實例并創建了Hologres數據庫。

   • 賬號B的RAM角色要求及權限配置

     1. 賬號B需創建一個RAM角色并授權該角色可訪問指定Hologres實例。同時，RAM角色需添加賬號A為信任的云賬號，即允許賬號A使用此RAM角色。詳情請參見RAM角色授權模式。

     2. 修改RAM角色的權限策略，授權給賬號A，后續賬號A可使用此RAM角色來訪問Hologres。詳情請參見修改RAM角色的信任策略。

        策略內容如下。

        {
            "Version": "1",
            "Statement": [
                {
                    "Action": [
                        "sts:AssumeRole",
                        "hologram:GetInstance",
                        "hologram:ListInstances",
                        "hologram:ListWarehouses"
                    ],
                    "Effect": "Allow",
                    "Principal": {
                        "Service": [
                            "賬號A的阿里云賬號ID@engine.dataworks.aliyuncs.com"
                        ]
                    }
                }
            ]
        }

創建數據源

1. 進入數據源頁面。

   1. 登錄DataWorks控制臺，切換至目標地域后，單擊左側導航欄的更多 > 管理中心，在下拉框中選擇對應工作空間后單擊進入管理中心。

   2. 進入工作空間管理中心頁面后，單擊左側導航欄的數據源 > 數據源列表，進入數據源頁面。

2. 單擊新增數據源，選擇Hologres。在數據源配置頁面中配置數據源參數。

3. 配置基礎信息。

   您可根據界面提示配置數據源的名稱等基礎信息，核心配置參數如下表所示。

   說明

   標準模式工作空間，需分別創建開發環境數據源和生產環境數據源。工作空間模式，詳情請參見必讀：簡單模式和標準模式的區別。

   

   參數	說明
   數據源名稱	定義數據源在DataWorks的名稱，名稱必須唯一。
   認證方式	新建數據源時無需配置，默認支持通過阿里云賬號及阿里云RAM角色身份進行認證。 說明 歷史創建的存量數據源支持使用AccessID及AccessKey的認證方式，這類數據源建議后續修改認證方式為阿里云賬號及阿里云RAM角色。
   所屬云賬號	指定當前創建的數據源對應的Hologres實例屬于當前阿里云主賬號還是其他阿里云主賬號。 當前阿里云主賬號：添加當前阿里云主賬號下的Hologres實例作為當前工作空間的數據源。 其他阿里云主賬號：添加其他阿里云主賬號下的Hologres實例作為當前工作空間的數據源。 說明 此方式即可實現跨賬號創建數據源，數據源創建完成后僅支持通過RAM角色訪問的方式執行。
   地域	Hologres實例所在地域。 說明 若選擇的地域與當前工作空間地域不一致，則創建數據源后，此類數據源無法在DataWorks的數據開發（DataStudio）模塊綁定，即不支持在數據開發（DataStudio）、運維中心使用，僅可用于數據集成模塊進行數據同步。
   Hologres實例及訪問身份配置	所屬云賬戶不同時，Hologres實例及訪問身份的配置參數不同。 所屬賬號：當前阿里云主賬號 Hologres實例、數據庫名稱：在下拉框中選擇待添加為數據源的Hologres實例，并填寫已創建的Hologres數據庫名稱。您可以登錄Hologres控制臺，在實例列表頁面進入實例詳情頁，查看對應信息。 默認訪問身份：用于指定后續使用什么賬號訪問Hologres。 開發環境：默認使用當前的執行者（即當前的登錄賬號）訪問Hologres。 例如在數據開發頁面中創建并調試Hologres引擎任務時，即使用當前登錄數據開發頁面的阿里云賬號訪問對應的Hologres。 生產環境：您可以在下拉框中選擇使用主賬號或RAM賬號/RAM角色訪問Hologres。 說明 RAM角色相關操作請參見（進階）RAM角色登錄并使用DataWorks。 下拉框中可選的訪問身份類型與當前操作創建Hologres數據源的賬號有關，詳情可見界面提示。 例如在運維中心周期性調度Hologres任務時，即使用此處配置的訪問身份訪問對應的Hologres。 所屬賬號：其他阿里云主賬號 說明 此場景為創建跨賬號的Hologres實例為數據源，數據源創建完成后，僅支持通過RAM角色的方式訪問對應Hologres。并且該類數據源不能用于數據開發和調度。 對方阿里云主賬號UID、對方RAM角色：填寫跨賬號的阿里云賬號UID和RAM角色。后續即使用此阿里云賬號下的RAM角色訪問對應Hologres。 對方Hologres實例、對方數據庫名稱：填寫已創建的Hologres實例ID、Hologres數據庫名稱。您可以登錄Hologres控制臺，在實例列表頁面進入實例詳情頁，查看對應信息。
   認證選項與SSL加密模式	選擇訪問Hologres實例時，是否需要加密傳輸。 若認證選項選擇SSL認證，則需先確保對應Hologres實例已開啟傳輸加密，否則后續連接訪問Hologres實例會報錯。 重要 開啟SSL認證的數據源無法用于數據開發和調度。

4. 測試資源組連通性。

   根據使用場景不同，資源組分為數據集成（用于數據同步）、數據調度（用于任務調度）、數據服務（用于數據服務任務）這些類型。各類資源組的詳細介紹請參見DataWorks資源組概述。

   您需根據數據源后續的用途，在對應資源組類型頁簽下，測試所需資源組的連通性。若資源組與數據源無法連通，則相應數據源任務將無法正常執行。

后續操作

為保障您的開發過程更加順暢，建議先閱讀DataWorks On Hologres使用說明，了解在DataWorks使用Hologres的開發流程、相關費用、環境準備、權限控制等內容。

數據源創建完成后，您可根據需要執行如下操作：

• 計算任務開發與調度：

  DataWorks的數據開發與運維中心模塊，為您提供Hologres任務的開發與調度能力，若您需要基于該Hologres數據源進行Hologres任務開發，或周期性調度Hologres相關任務，需先進入數據開發（DataStudio）頁面，將創建的數據源綁定至數據開發（DataStudio）。

  說明

  僅當Hologres實例和DataWorks工作空間同地域、同賬號時，基于該項目創建的數據源才可綁定至數據開發（DataStudio）。

• 進行數據同步：

  DataWorks的數據集成模塊為您提供讀取和寫入數據至Hologres的能力，您可將其他數據源的數據同步至當前Hologres數據源，或將當前Hologres數據源的數據同步至其他數據源。同時，可根據需要選擇離線同步、實時同步、同步解決方案等場景執行相關數據同步操作。

• 增刪改查數據源：進入數據源管理頁面執行編輯、刪除等管理操作。