個人を特定できる情報 (PII) エンティティを認識する

  • 5 分

PII (個人を特定できる情報) の検出は、Azure 言語によって提供される機能です。 個人を特定できる情報 (PII) を非構造化テキストで識別、分類、編集します。 PII には、メール アドレス、電話番号、支払い情報などが含まれます。

PII 検出 API を呼び出すには、いくつかの方法があります。 ここでは、 azure_ai 拡張機能を使用して、SQL クエリのテキストから PII を処理します。

[前提条件]

azure_ai拡張機能を有効にして構成した Azure Database for PostgreSQL フレキシブル サーバーが必要です。 また、言語リソースのキーとエンドポイントを設定して、Azure Cognitive Services で 承認 する必要があります。

シナリオ

PII 検出は、次のような複数のアプリケーションに使用します。

  • 秘密度ラベル: PII の種類に応じて、秘密度別にドキュメントまたはメールを分類します。 電話番号を含むテキストは機密としてマークされる場合があります。一方、クレジット カードまたは銀行口座番号には非常に秘密度の高いラベルが付けられます。
  • サポートと運用のための情報削除: インシデントトリアージやサポートルーティングなどの多くの運用タスクでは、個人情報は必要ありません。 企業は PII の編集を使用して、従業員のタスクに不要な顧客情報をフィルター処理できます。
  • 無意識の偏りを減らすために個人情報を減らす: 企業は、無意識の性別やその他の偏りを軽減するために、名前、住所、その他の情報を削除できます。

Azure Cognitive Services を使用した SQL での PII の検出

Azure Database for PostgreSQL フレキシブル サーバー azure_ai拡張機能 は、SQL 内から直接 AI 機能にアクセスするためのユーザー定義関数 (UDF) を提供します。 PII 検出 API には、azure_cognitive.recognize_pii_entitiesによって提供されるazure_ai関数を使用してアクセスします。

azure_cognitive.recognize_pii_entities(
 text text,
 language text,
 timeout_ms integer DEFAULT 3600000,
 throw_on_error boolean DEFAULT true,
 domain text DEFAULT 'none'::text,
 disable_service_logs boolean DEFAULT false
)

必要なパラメーターは、textが書き込まれる言語language、入力、およびtextです。 たとえば、 en-us は米国英語で、 fr はフランス語です。 使用可能な 言語 の完全な一覧については、言語サポートを参照してください。

既定では、エンティティの認識が 3,600,000 ミリ秒 = 1 時間で終了しない場合、停止されます。 この遅延をカスタマイズするには、 timeout_msを変更します。

エラーが発生した場合、既定の動作では例外がスローされ、トランザクションがロールバックされます。 この動作を無効にするには、 throw_on_error を false に設定します。

domain パラメーターを使用して、識別される個人データの種類をカスタマイズできます。 現在、既定の none では一般的な PII が使用されており、ドメイン phi は個人の健康情報を識別します。

パラメーターの完全なドキュメントについては、 Azure Cognitive Services 拡張機能のドキュメント を参照してください。

たとえば、次のクエリを呼び出します。

SELECT azure_cognitive.recognize_pii_entities('My phone number is +1555555555, and the address of my office is 16255 NE 36th Way, Redmond, WA 98052.', 'en-us');

次の結果が得られます。

("My phone number is ***********, and the address of my office is ************************************.","{""(+1555555555,PhoneNumber,\\""\\"",0.8)"",""(\\""16255 NE 36th Way, Redmond, WA 98052\\"",Address,\\""\\"",1)""}")

PII サービスは、信頼度スコアが 0.8 の電話番号と信頼度スコアが 1 のアドレスを検出しました。 また、2 つの PII データ ポイントが編集された入力も返されました。

入力テキストにはテーブル列を使用できます。

SELECT description, azure_cognitive.recognize_pii_entities(description, 'en-us')
FROM listings LIMIT 1;

次の値が返されます ( \x 拡張表示が有効な場合)。

recognize_pii_entities | ("New modern house built in 2013. Spectacular sunset/water views, light, rooftop deck and lounge area, hot tub, 5 bedrooms, gourmet kitchen. Perfect for 2-3 families, walk to downtown. Located in highly desirable Queen Anne neighborhood. Our house is modern, light and fresh with a warm simple palette accented with barnwood, steel and concrete. Open living spaces for entertaining, gourmet kitchen, deck off the kitchen, reading nook, half bath and smaller tv room off kitchen. Fireplace with sofa and sitting area. Basement room is great for ****...this room has patio access and a garage door that opens into the space with basketball hoop right outside. A queen bedroom and full bath are in the basement with concrete heated floors. A queen sleeper sofa is in the tv area in the basement. This room has a door if privacy is needed. Great for a second ****** with ****. The 2nd floor has 4 bedrooms (one queen in master, one twin bedroom, another bedroom has twin bunk beds and the last","{""(kids,PersonType,\\""\\"",0.73)"",""(family,PersonType,\\""\\"",0.71)"",""(kids,PersonType,\\""\\"",0.65)""}")

概要

PII 検出では、個人を特定できる情報が非構造化入力テキストで識別され、分類されます。 Azure Cognitive Services 言語モデルでは負荷が高く、Azure Database for PostgreSQL の azure_ai 拡張機能では、SQL クエリ内から直接 PII を検出して編集するための azure_cognitive.recognize_pii_entities API が提供されます。