매핑으로 스키마 설정

주의: Document AI Warehouse는 지원 중단되었으며 2025년 1월 16일 이후에는 Google Cloud에서 더 이상 사용할 수 없습니다. 데이터를 보호하려면 현재 Document AI Warehouse에 저장된 문서를 Cloud Storage와 같은 대체 위치로 이전하세요. 데이터 손실을 방지하려면 지원 중단일 전에 데이터 이전이 완료되었는지 확인하세요. 자세한 내용은 지원 중단을 참고하세요.

추출된 항목을 Document AI Warehouse 속성으로 변환해야 하는 경우 스키마를 설정하거나 업데이트해야 합니다.

참고: 스키마 매핑은 수집 및 Document AI로 처리 파이프라인에서만 지원됩니다. 일반 문서 생성 호출은 매핑을 트리거하지 않습니다.

매핑을 사용하여 스키마를 설정하기 전에 Document AI 프로세서 유형과 스키마, 항목 유형을 알아야 합니다. 파이프라인은 중첩된 항목을 평면화하므로 하위 항목의 매핑도 만들어야 합니다.

예를 들어 프로세서 INVOICE_PROCESSOR에는 다음과 같은 항목 유형이 있습니다.

• line_item
• line_item/amount
• total_amount

참고: 스키마에 없는 항목 유형 (속성 이름 또는 schema_source 이름)의 모든 항목은 삭제됩니다.

{
  "property_definitions": [
    {
      "name": "line_item",
      "display_name": "line_item",
      "is_searchable": true,
      "is_filterable": true,
      "text_type_options": {}
    },
    {
      "name": "my_new_receiver_name",
      "display_name": "my_new_receiver_name",
      "is_searchable": true,
      "is_filterable": true,
      "text_type_options": {},
      "schema_sources": [
        {
          "name": "receiver_name_in_invoice",
          "processor_type": "INVOICE_PROCESSOR"
        },
        {
          "name": "receiver_name_in_w2",
          "processor_type": "FORM_W2_PROCESSOR"
        }
      ]
    }
  ]
}

속성 이름을 항목 유형과 동일하게 유지하려면 위의 예와 같이 line_item와 같은 이름을 직접 사용하면 됩니다. 인보이스 프로세서의 유형이 receiver_name_in_invoice이고 양식 W2 프로세서의 유형이 receiver_name_in_w2인 모든 항목을 새 이름 my_new_receiver_name로 변환하려면 위의 예와 같이 schema_sources 필드에 매핑을 추가하면 됩니다. 하지만 변환 후에는 my_new_receiver_name를 사용하여 검색하고 필터링합니다. 속성 이름과 schema_source 이름은 고유해야 합니다.