連線到 Microsoft Purview 中的 Snowflake 並管理

重要事項

僅淘汰 Microsoft Purview 資料控管功能

Microsoft Purview 統一目錄和傳統 Microsoft Purview 資料控管功能 (先前的 Azure Purview) 即將淘汰。 整個 Microsoft Purview 並未淘汰。 Microsoft Purview 資料安全性與合規性功能不受此公告影響,且 Microsoft 會繼續投資於此功能。

Microsoft 正在 Microsoft Fabric 中合併 其資料控管 功能。 無法再建立新的 Microsoft Purview 資料控管帳戶,而且現有的資料控管功能將維持在維護模式,直到 2027 年 11 月 12 日為止。

如需淘汰時間表、轉換指引,以及建議的後續步驟,請參閱 Microsoft Purview 資料控管淘汰公告。

本文概述如何註冊 Snowflake,以及如何在 Microsoft Purview 中驗證 Snowflake 並與之互動。 如需有關 Microsoft Purview 的詳細資訊,請參閱 Microsoft Purview 概觀。

重要事項

Snowflake 宣佈淘汰基本驗證 ,並計劃在 2026 年 8 月之前停用它。 為了配合變更並避免任何服務中斷,使用 Snowflake 資料對應連接器的 Microsoft Purview 客戶應轉換為金鑰組 (SHIR) 驗證。

建議的動作 (2026 年 7 月之前完成) :為了為客戶提供更多時間,Snowflake 允許類型 LEGACY_SERVICE 的服務使用者繼續使用基本驗證,直到 2026 年 7 月。 此原則有助於確保您的服務在轉換到新的驗證方法時不會中斷。 您可以在有限的時間內繼續使用基本驗證,同時設定和驗證新的驗證機制金鑰組。

建議Microsoft Purview 客戶將其使用者更新為 LEGACY_SERVICE 類型。 此變更可確保持續存取並提供更多時間來完成轉換。 此更新必須在 2026 年 7 月底之前透過在 Snowflake 中執行以下命令來完成:

*ALTER USER <purview_user_name> SET TYPE = LEGACY_SERVICE;

從 2026 年 8 月開始,不允許建立具有 LEGACY_SERVICE 類型的新使用者。

支援的功能

下列各節說明掃描 Microsoft Purview 中的 Snowflake 時可用的功能。

掃描功能

下表摘要說明 Microsoft Purview 中 Snowflake 支援的掃描功能。

中繼資料擷取 完整掃描 累加式掃描 範圍掃描
是 是 否 是

掃描 Snowflake 來源時,Microsoft Purview 支援:

  • 擷取技術中繼資料,包括:

    • 伺服器
    • 資料庫
    • Schemas
    • 資料表包含資料行、外部索引鍵和唯一限制式
    • 檢視包括資料行
    • 預存程序,包括參數 dataset 和結果集
    • 函數,包括參數 dataset
    • 管道
    • 階段
    • 包含資料行的串流
    • 工作
    • Sequences
  • 擷取資料表、檢視、資料流程和預存程序之間資產關係的靜態沿襲。

對於預存程序,您可以在 [ 建立並執行掃描 ] 區段中選擇要擷取的詳細層級。 Snowflake 指令碼 (SQL) 和 JavaScript 語言支援預存程序沿襲,並根據程序定義產生。

設定掃描時,您可以選擇完全根據給定名稱或名稱模式掃描一或多個 Snowflake 資料庫,或進一步將掃描範圍限定為符合給定名稱或名稱模式的結構描述子集。

其他功能

如需 分類、 敏感度標籤、 原則、 資料沿襲和 即時檢視,請參閱 支援的功能清單。

已知限制

掃描 Microsoft Purview 中的 Snowflake 時,請注意下列限制。

  • 當您從資料來源刪除物件時,後續掃描不會自動移除 Microsoft Purview 中的對應資產。
  • 下列模式不支援預存程序沿襲:
    • 以 Java、Python 和 Scala 語言定義的預存程序。
    • 使用 SQL EXECUTE IMMEDIATE 的預存程序,並以靜態 SQL 查詢做為變數。

必要條件

掃描的必要權限

Microsoft Purview 支援掃描 Snowflake 時 (使用者名稱和密碼) 的基本驗證。 指定使用者的預設角色將用於執行掃描。 Snowflake 使用者必須擁有倉儲和要掃描資料庫的使用權限,以及系統資料表的讀取存取權,才能存取進階中繼資料。

以下是專門針對 Microsoft Purview 建立使用者掃描並設定權限的範例逐步解說。 如果您選擇使用現有使用者,請確定該使用者對倉儲和資料庫物件具有足夠的權限。

  1. 設定角色 purview_reader 。 您必須具備 ACCOUNTADMIN 權限才能執行這項操作。

    USE ROLE ACCOUNTADMIN;
    
    --create role to allow read only access - this will later be assigned to the Microsoft Purview user
    CREATE OR REPLACE ROLE purview_reader;
    
    --make sysadmin the parent role
    GRANT ROLE purview_reader TO ROLE sysadmin;
    
  2. 建立倉儲供 Microsoft Purview 使用和授與權限。

    --create warehouse - account admin required
    CREATE OR REPLACE WAREHOUSE purview_wh WITH 
        WAREHOUSE_SIZE = 'XSMALL' 
        WAREHOUSE_TYPE = 'STANDARD' 
        AUTO_SUSPEND = 300 
        AUTO_RESUME = TRUE 
        MIN_CLUSTER_COUNT = 1 
        MAX_CLUSTER_COUNT = 2 
        SCALING_POLICY = 'STANDARD';
    
    --grant rights to the warehouse
    GRANT USAGE ON WAREHOUSE purview_wh TO ROLE purview_reader;
    
  3. 建立 Microsoft Purview 掃描使用者 purview 。

    CREATE OR REPLACE USER purview 
        PASSWORD = '<password>'; 
    
    --note the default role will be used during scan
    ALTER USER purview SET DEFAULT_ROLE = purview_reader;
    
    --add user to purview_reader role
    GRANT ROLE purview_reader TO USER purview;
    
  4. 授與資料庫物件的讀取者權限。

    GRANT DATABASE ROLE SNOWFLAKE.OBJECT_VIEWER TO USER purview_reader;
    GRANT USAGE ON DATABASE <your_database_name> TO purview_reader;
    
    --grant reader access to all the database structures that purview can currently scan
    GRANT USAGE ON ALL SCHEMAS IN DATABASE <your_database_name> TO role purview_reader;
    GRANT USAGE ON ALL FUNCTIONS IN DATABASE <your_database_name> TO role purview_reader;
    GRANT USAGE ON ALL PROCEDURES IN DATABASE <your_database_name> TO role purview_reader;
    GRANT SELECT ON ALL TABLES IN DATABASE <your_database_name> TO role purview_reader;
    GRANT SELECT ON ALL VIEWS IN DATABASE <your_database_name> TO role purview_reader;
    GRANT USAGE, READ on ALL STAGES IN DATABASE <your_database_name> TO role purview_reader;
    
    --grant reader access to any future objects that could be created
    GRANT USAGE ON FUTURE SCHEMAS IN DATABASE <your_database_name> TO role purview_reader;
    GRANT USAGE ON FUTURE FUNCTIONS IN DATABASE <your_database_name> TO role purview_reader;
    GRANT USAGE ON FUTURE PROCEDURES IN DATABASE <your_database_name> TO role purview_reader;
    GRANT SELECT ON FUTURE TABLES IN DATABASE <your_database_name> TO role purview_reader;
    GRANT SELECT ON FUTURE VIEWS IN DATABASE <your_database_name> TO role purview_reader;
    GRANT USAGE, READ ON FUTURE STAGES IN DATABASE <your_database_name> TO role purview_reader;
    

登錄

本節說明如何使用傳統 Microsoft Purview 管理入口網站在 Microsoft Purview 中註冊 Snowflake。

註冊步驟

若要在 Microsoft Purview 統一目錄中註冊新的 Snowflake 來源,請遵循下列步驟:

  1. 在傳統 Microsoft Purview 管理入口網站中瀏覽至您的 Microsoft Purview 帳戶。
  2. 選取左側導覽中的 [資料對應 ]。
  3. 選取 [註冊]。
  4. 在 [註冊來源] 上,選取 [雪花]。 選取 [繼續]。

在 [ (Snowflake 註冊來源]) 畫面上,遵循下列步驟:

  1. 輸入資料來源將在目錄中列出的 名稱 。

  2. 以 的形式輸入 伺服器 URL <account_identifier>.snowflakecomputing.com,例如 orgname-accountname.snowflakecomputing.com。 深入瞭解 Snowflake 帳戶識別碼。 請注意,此 URL 會做為 Snowflake 資產完整名稱的一部分,而且是 Microsoft Purview 在掃描期間連線至 Snowflake 的預設端點。

  3. 如果適用,請新增 其他主機 。 當您希望掃描作業連線到伺服器 URL 以外的 Snowflake 端點時,請指定它。 您可以在掃描設定期間選擇要連線的主機。

    提示

    如果您已經掃描 Snowflake,但想要切換以使用另一個端點,例如,從公用端點移至私人端點,您可以在資料來源中新增另一個主機,並在掃描中選擇該主機進行連線,以確保 Microsoft Purview 產生的資產與先前具有相同的完整名稱。

    註冊資料來源時,Microsoft Purview 會執行唯一性檢查,確保伺服器 URL 和其他主機不會與任何現有來源重疊。

  4. 從清單中選取集合。

  5. 完成以註冊資料來源。

    螢幕擷取畫面,顯示 Microsoft Purview 中 Snowflake 的 [註冊來源] 頁面,其中包含名稱、伺服器 URL 和集合欄位。

掃描

請依照下列步驟掃描 Snowflake 以自動識別資產。 如需一般掃描的詳細資訊,請參閱我們的 掃描和擷取簡介。

掃描的驗證

Snowflake 來源支援的驗證類型為 基本驗證 和 金鑰組。

請遵循此程序來設定金鑰組認證。

金鑰組驗證的必要條件

開始之前,請確定您已:

  1. Snowflake 存取

    1. 具有系統管理員權限的 Snowflake 帳戶

    2. Microsoft Purview 掃描 (的使用者帳戶例如,purview_scanner)

    3. 存取執行 ALTER USER 命令

  2. 工具 & 軟體

    1. OpenSSL 安裝 (用於金鑰產生)

    2. 金鑰保存庫作業的 Azure CLI 或 PowerShell ()

    3. 存取 Microsoft Purview 入口網站

    4. 確定您已安裝 Microsoft Open JDK 11。 下載 Microsoft Open JDK 11。 其他 JDK 變體可能有進階加密演算法的問題。

逐步設定

第 1 部分:Snowflake 設定

此步驟涉及建立公開和私密金鑰,然後將公開金鑰指派給權限使用者 ( 'purview_scanner',如下範例) ,用於連線到 Snowflake 以執行掃描。

步驟 1.1:產生 RSA 金鑰組

  • 產生私密金鑰

開啟終端機並產生私密金鑰:

--For Encrypted Private Key (Recommended):  

openssl genrsa 2048 | openssl pkcs8 -topk8 -v2 aes-256-cbc -v2prf hmacWithSHA512 - inform PEM -out rsa_key.p8  

--Note: You'll be prompted to enter a passphrase. Remember this passphrase! 

OR

--For Unencrypted Private Key:  

openssl genrsa 2048 | openssl pkcs8 -topk8 -v2 aes-256-cbc -v2prf hmacWithSHA512 - inform PEM -out rsa_key.p8 -nocrypt 

注意:使用上述命令來產生金鑰

  • 產生公開金鑰
openssl rsa -in rsa_key.p8 -pubout -out rsa_key.pub 
  • 擷取公開金鑰內容

檢視和複製公開金鑰內容, (排除標頭) :

cat rsa_key.pub 
-----BEGIN PUBLIC KEY----- 
MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA... 
... -----END PUBLIC KEY----- 

複製 BEGIN 和 END 行之間的所有內容 (不包括分隔符號行) 。

步驟 1.2:將公開金鑰指派給 Snowflake 使用者

連線至 Snowflake 並執行:

-- Create user if it doesn't exist 
CREATE USER IF NOT EXISTS purview_scanner 
  DEFAULT_ROLE = 'PUVRIEW_READER' 
  TYPE = 'SERVICE'  ; 
 -- Assign the public key (paste your key without the BEGIN/END lines) 
ALTER USER purview_scanner  
SET RSA_PUBLIC_KEY='MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA...'; 
 -- Grant necessary privileges 
GRANT ROLE purview_reader TO USER purview_scanner; 
 -- Verify the fingerprint 
DESC USER purview_scanner; 

步驟 1.3:驗證金鑰組態 [選擇性驗證步驟]

驗證公開金鑰指紋相符:

在雪花中:

DESC USER purview_scanner ->> SELECT SUBSTR( 
(SELECT "value" FROM $1 
WHERE "property" = 'RSA_PUBLIC_KEY_FP'), 
LEN('SHA256:') + 1) AS key; 

在命令列中:

openssl rsa -pubin -in rsa_key.pub -outform DER | openssl dgst -sha256 -binary | openssl 
enc -base64 

請注意,兩者應該會產生相同的指紋雜湊。

第 2 部分:Azure Key Vault 設定

步驟 2.1:準備私密金鑰內容

檢視您的私密金鑰:

cat rsa_key.p8 

複製整個內容,包括 -----BEGIN ENCRYPTED PRIVATE KEY----- 與 -----END ENCRYPTED PRIVATE KEY----- 行。

步驟 2.2:將秘密儲存在 Azure Key Vault

您必須在 Azure Key Vault 中儲存兩個密碼:

祕密 1:私密金鑰

關鍵需求:私密金鑰 必須使用 Azure CLI 或 Azure Cloud Shell 儲存。

請勿使用 Azure 入口網站 UI 建立私密金鑰,因為:

  • Azure 入口網站文字輸入不會保留多行格式設定

  • 它將換行符號轉換為空格,從而損壞 PEM 格式

  • Snowflake 連接將因 格式錯誤的金鑰錯誤而失敗

密碼/密碼片語密碼可以透過入口網站 (單行值) 建立。

方法 1:建議) Azure CLI (

# Replace with your values 
KEY_VAULT_NAME="your-keyvault-name"
CREDENTIAL_NAME="snowflake-purview-cred" 

# Store the private key from file (preserves multi-line format) 
az keyvault secret set \
 --vault-name $KEY_VAULT_NAME \
 --name "${CREDENTIAL_NAME}-privateKey" \
 --file rsa_key.p8 

OR

方法 2:Azure Cloud Shell

  1. 開啟 Azure Cloud Shell (https://shell.azure.com)

  2. 使用資料夾圖示 (上傳按鈕上傳 rsa_key.p8 檔案)

  3. 執行命令:

az keyvault secret set \ 
  --vault-name your-keyvault-name \ 
  --name "snowflake-purview-cred-privateKey" \ 
  --file rsa_key.p8 

OR

方法 3:PowerShell 搭配 Azure CLI

# Read the private key preserving line breaks 
$privateKeyContent = Get-Content -Path "rsa_key.p8" -Raw 
 
# Store in Key Vault using Azure CLI 
az keyvault secret set ` 
  --vault-name "your-keyvault-name" ` 
  --name "snowflake-purview-cred-privateKey" ` 
  --value $privateKeyContent 

OR

上傳後驗證私密金鑰格式:[選擇性步驟]

# Retrieve and check the secret maintains proper formatting 
az keyvault secret show \ 
  --vault-name $KEY_VAULT_NAME \ 
  --name "${CREDENTIAL_NAME}-privateKey" \ 
  --query value -o tsv 
 
# Expected output: Multiple lines like this 
# -----BEGIN ENCRYPTED PRIVATE KEY----- 
# MIIFHDBOBgkqhkiG9w0BBQ0wQTApBgkqhkiG9w0BBQwwHAQI... 
# (multiple lines of base64 encoded content) 
# ... 
# -----END ENCRYPTED PRIVATE KEY-----

正確:保留分行符號的多行

不正確:單長行或含有空格而非換行符的文字

秘密 2:私密金鑰密碼

您可以使用 Azure 入口網站或 Azure CLI 建立 密碼, (它是單行值) 。

# Store the passphrase (if your key is encrypted) 
az keyvault secret set \
 --vault-name $KEY_VAULT_NAME \
 --name "${CREDENTIAL_NAME}-password" \
 --value "your_passphrase_here" 

重要: 如果您使用 未加密的 私密金鑰,您仍然需要建立 .password 密碼,但將其設定為空白字串或預留位置值。

使用 Azure 入口網站:

  1. 移至 [祕密] →產生/匯入

  2. 名稱: snowflake-purview-cred.password

  3. 值:您的密碼片語 (或未加密金鑰的空字串)

  4. 選取 [建立]

建立並執行掃描

若要建立並執行新的掃描,請遵循下列步驟:

  1. 在傳統 Microsoft Purview 管理入口網站中,瀏覽至 [ 來源]。

  2. 選取已註冊的 Snowflake 來源。

  3. 選取 [+ 新增掃描]。

  4. 提供下列詳細資料:

    1. 名稱:掃描的名稱

    2. 透過整合執行階段連線:根據您的案例,選取 Azure 自動解析整合執行階段、受控虛擬網路 IR 或 SHIR。 深入了解: 選擇適合您案例的整合執行階段設定。 若要使用受控虛擬網路 IR 透過 Private Link 連線到 Snowflake,請依 照透過受控私人端點連線到 Snowflake 中的步驟先設定私人端點。

    3. 用於連線的主機:選擇在掃描期間用於建立與 Snowflake 連線的端點。 您可以從伺服器 URL 或您在 [註冊] 中設定的其他主機中進行選擇。

    4. 認證:選取認證以連線至您的資料來源。

      如果在建立認證時使用 基本驗證 。

      • 在 [使用者名稱] 輸入欄位中提供用於連線到 Snowflake 的使用者名稱。
      • 將用於連線到 Snowflake 的使用者密碼儲存在金鑰中。

      如果在建立認證時使用金鑰組

      • 提供使用者名稱:purview_scanner (您的 Snowflake 使用者)

      • 密碼金鑰保存庫參考:

      • 金鑰保存庫連線: 選取您的金鑰保存庫

      • 秘密名稱:snowflake-purview-cred.password

      • 私密金鑰保存庫參考:
      • 金鑰保存庫連線: 選取您的金鑰保存庫

      • 秘密名稱:snowflake-purview-cred.privateKey

    5. 倉庫:以大寫指定用於啟用掃描的倉庫實例名稱。 指派給認證中指定使用者的預設角色必須具有此倉儲的 USAGE 權限。

    6. 資料庫:指定一或多個要匯入的大寫資料庫執行個體名稱。 以分號 (;) 分隔清單中的名稱。 例如,DB1;DB2。 指派給認證中指定使用者的預設角色必須具有資料庫物件的足夠權限。

      注意事項

      指定多個資料庫執行個體名稱時,分類不會套用至資料表。

      可接受的資料庫名稱模式可以是靜態名稱或包含萬用字元 %。 例如: A%;%B;%C%;D

      • 以 A 或
      • 結尾為 B 或
      • 包含 C 或
      • 等於 D
    7. 架構:列出要匯入的架構子集,以分號分隔清單表示。 例如,schema1;schema2。 如果該清單是空的,則會匯入所有使用者結構描述。 預設會忽略所有系統架構和物件。

      可接受的結構描述名稱模式使用,可以是靜態名稱或包含萬用字元 %。 例如: A%;%B;%C%;D

      • 以 A 或
      • 結尾為 B 或
      • 包含 C 或
      • 等於 D

      不能接受使用 NOT 和特殊字元。

    8. 預存程序詳細資料:控制從預存程序匯入的詳細資料數目:

      • 簽章 (預設) :預存程序的名稱和參數。
      • 程式碼、簽章:預存程序的名稱、參數和程式碼。
      • 沿襲、程式碼、簽章:預存程序的名稱、參數和程式碼,以及從程式碼衍生的資料沿襲。
      • 無:不包含預存程序詳細資料。

      注意事項

      如果您使用自我裝載整合執行階段進行掃描,自版本 5.30.8541.1 起支援預設簽章以外的自訂設定。 舊版一律會擷取預存程序的名稱和參數。

    9. 使用自我裝載整合執行階段時適用的可用記憶體上限 () : 客戶 VM 上可供掃描處理程序使用的記憶體 (上限) 以 GB 為單位。 這取決於要掃描的 Snowflake 來源大小。

      注意事項

      根據經驗,每 1000 個資料表提供 1GB 記憶體。

  5. 選取 [ 測試連線 ] 以驗證使用 Azure Integration Runtime) 時 (可用的設定。

  6. 選取 [繼續]。

  7. 選取要分類的 掃描規則集 。 您可以在系統預設、現有自訂規則集之間進行選擇,或以內嵌方式 建立新的規則集 。 如需詳細資訊,請參閱 在 Microsoft Purview 中自動套用分類。

    注意事項

    當資料表名稱、檢視名稱、結構描述名稱或資料庫名稱包含特殊字元時,分類不會套用至資料表或檢視。

    注意事項

    如果您使用的是自我裝載執行階段,則必須升級至 5.26.404.1 版或更新版本,才能使用 Snowflake 分類。 下載最新的 Microsoft 整合執行階段。

  8. 選擇您的 掃描觸發程序。 您可以設定排程或執行掃描一次。

  9. 檢閱您的掃描,然後選取 [儲存並執行]。

檢視您的掃描與掃描執行

若要檢視現有掃描:

  1. 移至 Microsoft Purview 入口網站。 在左側窗格中,選取資料 對應。
  2. 選取資料來源。 您可以在 [最近的掃描] 底下檢視該資料來源上的現有掃描清單,也可以在 [ 掃描 ] 索引標籤上檢視所有掃描。
  3. 選取您要檢視結果的掃描。 窗格會顯示所有先前的掃描執行,以及每個掃描執行的狀態和計量。
  4. 選取執行 ID 以檢查 掃描執行詳細資料。

管理您的掃描

若要編輯、取消或刪除掃描:

  1. 移至 Microsoft Purview 入口網站。 在左窗格中,選取 [資料對應]。

  2. 選取資料來源。 您可以在 [最近的掃描] 底下檢視該資料來源上的現有掃描清單,也可以在 [ 掃描 ] 索引標籤上檢視所有掃描。

  3. 選取您要管理的掃描。 然後您可以:

    • 選取 [ 編輯掃描] 來編輯掃描。
    • 選取 [ 取消掃描執行] 以取消進行中的掃描。
    • 選取 [刪除掃描] 以刪除掃描。

注意事項

  • 刪除掃描不會刪除從先前掃描建立的目錄資產。

譜系

掃描 Snowflake 來源之後,您可以 瀏覽 Unified Catalog 或 搜尋 Unified Catalog 以檢視資產詳細資料。

移至資產 -> 沿襲索引標籤,您可以在適用時查看資產關係。 請參閱支援的 Snowflake 沿襲案例上的 支援功能 章節。 如需一般沿襲的詳細資訊,請參閱 資料沿襲 和 沿襲使用者指南。

雪花沿襲檢視

注意事項

如果檢視是由來自不同資料庫或不同結構描述的資料表所建立,請使用分號 (;) 清單中的名稱,同時掃描所有資料庫和結構描述。

透過受管理的私人端點連線到 Snowflake

本節說明設定從 Microsoft Purview 到 Azure 上的 Snowflake 的受管理私人端點 (PE) 所需的步驟。 深入瞭解 Azure 專屬連結和 Snowflake。

  1. 在您的 Snowflake 帳戶中,擷取目標端點和資源 ID。 以帳戶管理員角色執行系統函數 SYSTEM$GET_PRIVATELINK_CONFIG () ,並記下下列屬性的值:

    • privatelink-pls-id
    • privatelink-account-url
    • regionless-privatelink-account-url
    • privatelink_ocsp-url
    use role accountadmin; 
    select key, value::varchar from table(flatten(input=>parse_json(SYSTEM$GET_PRIVATELINK_CONFIG())));
    
  2. 在 Microsoft Purview 中,建立 Snowflake 的受管理私人端點。

    1. 依照步驟建立 受管理虛擬網路整合執行階段。 如果您已經有一個,請確定它是支援 Snowflake PE 的版本 2。
    2. 為 Snowflake 建立受管理的私密端點。 瀏覽至 [受管理的私人端點] ->+ [新增 ->Snowflake],然後填寫下列資訊。
      • 資源識別碼或別名:填入您擷取的 privatelink-pls-id 值。
      • 完整網域名稱:新增 privatelink_ocsp-url、 regionless-privatelink-account-url 和 privatelink-account-url。

    Microsoft Purview 中 Snowflake 的受管理私人端點建立頁面螢幕擷取畫面。

  3. 建立 PE 之後,您可以看到其佈建狀態為 [成功 ],而核准狀態為 [擱置中]。 開啟 PE,並在詳細資料頁面中尋找 受管理的私人端點資源識別碼 。

  4. 請連絡 Snowflake 技術支援 並提供資源 ID,讓 Snowflake 核准此 PE。

  5. 一旦 Snowflake 支援確認 PE 已核准,您應該會在 Microsoft Purview 中看到受管理的私人端點核准狀態為 已核准 。

  6. 登錄資料來源 並 設定掃描。 設定掃描時,選擇與 Snowflake PE 相關聯的受管理虛擬網路 IR。

疑難排解提示

如果您在註冊或掃描 Snowflake 時遇到問題,請檢閱以下提示。

  • 在來源註冊步驟中檢查您的帳戶識別碼。 請勿在開頭加入 https:// 。
  • 確保掃描設定頁面上的倉庫名稱和資料庫名稱是大寫。
  • 檢查您的金鑰保存庫。 確認密碼沒有輸入錯誤。
  • 檢查您在 Microsoft Purview 中設定的認證。 您指定的使用者必須具有對您要掃描的倉儲和資料庫的必要存取權限的預設角色。 請參閱 掃描的必要權限。 DESCRIBE USER;用來驗證您為 Microsoft Purview 指定的使用者預設角色。
  • 使用 Snowflake 中的查詢歷程記錄來查看是否有任何活動發生。
    • 如果帳戶識別碼或密碼有問題,您不會看到任何活動。
    • 如果預設角色發生問題,您至少應該會看到 USE WAREHOUSE . . . 聲明。
    • 您可以使用 QUERY_HISTORY_BY_USER表函數 來識別連線正在使用的角色。 設定專屬的 Microsoft Purview 使用者,可讓您更輕鬆地進行疑難排解。

金鑰組驗證疑難排解

本節涵蓋在 Microsoft Purview 中使用 Snowflake 金鑰組驗證時的常見連線問題。

問題 1:「測試連線失敗」

問題:Purview 中的連線測試失敗

可能原因及解決方案:

  1. 未指派公開金鑰

    1. 在 Snowflake 中驗證: DESC USER purview_scanner;

    2. 檢查RSA_PUBLIC_KEY_FP是否填入

  2. 金鑰保存庫存取問題

    1. 驗證受控識別具有取得和清單權限

    2. 檢查金鑰保存庫防火牆設定

  3. 不正確的秘密名稱

    1. 驗證:{credentialName}.password 存在

    2. 驗證:{credentialName}.privateKey 存在

問題 2:「私密金鑰格式無效」或「連線失敗,出現金鑰錯誤」

徵狀:

  • 身份驗證失敗並顯示「無效的私密金鑰格式」錯誤

  • 連線測試立即失敗

  • 關於格式不正確的 PEM 或金鑰剖析錯誤的錯誤訊息

常見原因: 私密金鑰是透過 Azure 入口網站儲存 (損毀的多行格式)

解決方案:

  1. 確認金鑰格式是否損毀:

    # Retrieve the secret and check format 
    az keyvault secret show \
     --vault-name your-keyvault \
     --name "snowflake-purview-cred-privateKey" \
     --query value -o tsv | head -5 
    
    # Should show multiple lines starting with: 
    # -----BEGIN ENCRYPTED PRIVATE KEY----- 
    # MIIFHDBOBgkqhkiG9w0BBQ0wQTApBgkqhkiG9w... 
    # (NOT a single long line)
    
    
  2. 如果損毀,請使用 CLI 刪除並重新建立:

    # Delete the corrupted secret az keyvault secret delete \
     --vault-name your-keyvault \
     --name "snowflake-purview-cred-privateKey" 
    
    # Wait for soft-delete purge (or purge immediately if needed) 
    az keyvault secret purge \
     --vault-name your-keyvault \
     --name "snowflake-purview-cred-privateKey" 
    
    # Recreate using CLI with
     --file parameter az keyvault secret set \
     --vault-name your-keyvault \
     --name "snowflake-purview-cred-privateKey" \
     --file rsa_key.p8
    
  3. 其他檢查:

    1. 確保私密金鑰是 PKCS#8 PEM 格式

    2. 包括 -----BEGIN ENCRYPTED PRIVATE KEY----- 和 -----END ENCRYPTED PRIVATE KEY----- 行

    3. 首先在本機驗證金鑰:

    openssl rsa -in rsa_key.p8 -check
    

請記住: 一律使用 Azure CLI 或 Cloud Shell 作為私密金鑰,切勿使用 Azure 入口網站 UI。

問題 3:「公開金鑰指紋不符」

徵兆:驗證成功,但使用錯誤的金鑰

解決方案:

# Regenerate public key from private key 
openssl rsa -in rsa_key.p8 -pubout -out rsa_key_new.pub 

# Verify fingerprint 
openssl rsa -pubin -in rsa_key_new.pub -outform DER | openssl dgst sha256 -binary | openssl enc -base64 

# Update in Snowflake 
ALTER USER purview_scanner SET RSA_PUBLIC_KEY='';

問題 4:「密碼片語不正確」

徵兆: 金鑰解密失敗

解決方案:

  1. 驗證金鑰保存庫中的密碼片語與金鑰產生期間使用的密碼相符

  2. 在本機測試密碼:

openssl rsa -in rsa_key.p8 -check 
# Enter passphrase when prompted

問題 5:「遺失 Snowflake 權限」

徵兆:連線成功,但掃描失敗

解決方案:

將必要權限授予 Snowflake 使用者:

-- Create role for Purview 
CREATE ROLE IF NOT EXISTS purview_reader; 

-- Grant usage on warehouse 
GRANT USAGE ON WAREHOUSE COMPUTE_WH TO ROLE purview_reader; 

-- Grant usage on database  
GRANT USAGE ON DATABASE my_database TO ROLE purview_reader; 

-- Grant usage on all schemas  
GRANT USAGE ON ALL SCHEMAS IN DATABASE my_database TO ROLE  purview_reader; 

-- Grant select on all tables  
GRANT SELECT ON ALL TABLES IN DATABASE my_database TO ROLE  purview_reader;  
GRANT SELECT ON FUTURE TABLES IN DATABASE my_database TO ROLE  purview_reader; 

-- Grant select on all views  
GRANT SELECT ON ALL VIEWS IN DATABASE my_database TO ROLE  purview_reader;  
GRANT SELECT ON FUTURE VIEWS IN DATABASE my_database TO ROLE  purview_reader; 

-- Assign role to user  
GRANT ROLE purview_reader TO USER purview_scanner; 

-- Set as default role  
ALTER USER purview_scanner SET DEFAULT_ROLE = purview_reader;

現在您已註冊來源,請使用下列資源來深入了解 Microsoft Purview 和您的資料。