適用於:
Databricks SQL
Databricks Runtime
這個 ai_mask() 函式允許你調用最先進的 AI 模型,使用 SQL 遮罩指定文本中的實體。 此函式使用由 Databricks Foundation Model APIs 提供的聊天模型服務端點。
需求
Apache 2.0 授權
目前可能使用的底層模型依照 Apache 2.0 授權,版權屬於 © Apache 軟體基金會。 客戶應負責確保遵循適用的模型授權。
Databricks 建議檢閱這些授權,以確保符合任何適用的條款。 如果未來模型根據 Databricks 的內部基準檢驗而表現更好,Databricks 可能會變更模型(以及此頁面上提供的適用授權清單)。
- 此函式僅適用於支持 針對批次推斷優化之 AI Functions 的區域工作區。
- 此函數不適用於 Azure Databricks SQL Classic。
- Databricks 執行時需 15.4 LTS 或以上。 關於此要求即將變更,請參閱 AI 函數要求 Databricks Runtime 17.3 LTS 或以上版本。 建議使用 Databricks Runtime 18.2 或以上版本,以獲得最佳效能及使用最新功能。
- 檢查 Databricks SQL 定價頁面。
語法
ai_mask(content, labels)
引數
-
content:STRING運算式。 -
labels:ARRAY<STRING>字面值。 每個元素都是簡短且淺顯的描述,描述要遮蔽的資訊類型,例如'person'或'email'。
退貨
其中 STRING 每個偵測到的與其中一個 labels 相符的實體都會被替換為 [MASKED]。 每個標籤的替換文字都一樣。
如果 content 是 NULL,結果就是 NULL。
範例
以下範例涵蓋不同類型的實體。 由於 AI 模型會偵測實體,結果可能會有所不同。
> SELECT ai_mask(
'John Doe lives in New York. His email is john.doe@example.com.',
array('person', 'email')
);
"[MASKED] lives in New York. His email is [MASKED]."
> SELECT ai_mask(
'Contact me at 555-1234 or visit us at 123 Main St.',
array('phone', 'address')
);
"Contact me at [MASKED] or visit us at [MASKED]"
為了掩蓋政府身分證、付款資料和出生日期,請為每種類型傳遞標籤:
> SELECT ai_mask(
'SSN 123-45-6789, card 4111 1111 1111 1111, born on March 3, 1985.',
array('ssn', 'credit card number', 'date of birth')
);
"SSN [MASKED], card [MASKED], born on [MASKED]."
為了遮蔽網路識別碼,如 IP 位址和 URL,請執行以下操作:
> SELECT ai_mask(
'Login from 192.168.1.10 failed. See https://internal.example.com/logs for details.',
array('ip address', 'url')
);
"Login from [MASKED] failed. See [MASKED] for details."
要遮罩資料表欄位的每一列,請呼叫 ai_mask 一個查詢:
> SELECT
ticket_id,
ai_mask(ticket_text, array('person', 'email', 'phone', 'account number')) AS masked_text
FROM support_tickets;
限制
此函數不適用於 Azure Databricks SQL Classic。