<model_build_name>!PREDICT

스테이지의 문서에서 정보를 추출하여 JSON 오브젝트로 답변을 제공합니다. 단일 문서를 지정하면 해당 메서드는 해당 문서에 대한 결과를 반환합니다. 그렇지 않으면 해당 메서드는 해당 스테이지의 각 문서에 대한 결과를 반환합니다.

구문

<model_build_name>!PREDICT(<presigned_url>,
                           [ <model_build_version> ]
                          )
Copy

인자

필수:

presigned_url

스테이지 문서의 사전 서명된 URL.

미리 서명된 URL을 인자로 전달받으려면 GET_PRESIGNED_URL 함수를 호출합니다. GET_PRESIGNED_URL 섹션을 참조하십시오.

자세한 내용은 예 섹션을 참조하십시오.

참고

GET_PRESIGNED_URL 함수에는 기본 만료 시간(60분)이 있습니다. 만료 시간 연장에 대한 자세한 내용은 GET_PRESIGNED_URL 섹션을 참조하십시오.

선택 사항:

model_build_version

Document AI 모델 빌드의 버전입니다.

지정하지 않으면 기본적으로 사용 가능한 최신 모델 빌드 버전이 사용됩니다.

반환

다음 필드가 있는 JSON 오브젝트를 반환합니다.

ocrScore

광학 문자 인식(OCR) 프로세스에 대한 신뢰도 점수를 지정합니다.

score

특정 값에 대한 신뢰도 점수를 지정합니다.

value

질문에 대해 추출된 답변을 지정합니다.

{
  "__documentMetadata": {
    "ocrScore": 0.918
  },
  "invoice_number": [
    {
      "score": 0.925,
      "value": "123/20"
    }
  ],
  "invoice_items": [
    {
      "score": 0.839,
      "value": "NEW CRUSHED VELVET DIVAN BED"
    },
    {
      "score": 0.839,
      "value": "Vintage Radiator"
    },
    {
      "score": 0.839,
      "value": "Solid Wooden Worktop"
    },
    {
      "score": 0.839,
      "value": "Sienna Crushed Velvet Curtains"
    }
  ],
  "tax_amount": [
    {
      "score": 0.879,
      "value": "77.57"
    }
  ],
  "total_amount": [
    {
      "score": 0.809,
      "value": "465.43 GBP"
    }
  ],
  "buyer_name": [
    {
      "score": 0.925
    }
  ]
  "vendor_name": [
    {
      "score": 0.9,
      "value": "UK Exports & Imports Ltd"
    }
  ]
}
Copy

액세스 제어 요구 사항

Document AI 를 사용하여 정보를 추출하려면 SNOWFLAKE.DOCUMENT_INTELLIGENCE_CREATOR 데이터베이스 역할이 부여된 계정 역할을 사용해야 합니다. 자세한 내용은 Document AI 액세스 제어 섹션을 참조하십시오.

사용법 노트

  • 이 메서드를 사용하기 위한 전제 조건을 충족하는지 확인합니다. 자세한 내용은 전제 조건 섹션을 참조하십시오.

  • Document AI 에서는 한 번의 쿼리로 처리할 수 있는 문서 수에 제한이 있습니다. 자세한 내용은 Document AI 의 알려진 제한 사항 섹션을 참조하십시오.

  • 모든 문서는 해당 스테이지의 동일한 디렉터리에 있어야 합니다.

  • Document AI 는 디렉터리 테이블을 사용합니다. 자세한 내용은 디렉터리 테이블 쿼리하기 섹션을 참조하십시오.

  • Document AI 모델이 문서에서 답을 찾지 못하면 모델은 value 키를 반환하지 않습니다. 그러나 문서에 답이 포함되어 있지 않다고 모델이 판단한 수치를 나타내는 score 키를 반환합니다. 이에 대한 예제로 buyer_name 필드를 참조하십시오.

  • Document AI 모델은 목록을 반환할 수 있습니다. 이에 대한 예제로 invoice_items 필드를 참조하십시오.

예

다음 예제에서는 inspections 모델 빌드의 버전 1 에 대한 pdf_inspections_stage 스테이지의 모든 문서에서 정보를 추출합니다.

SELECT inspections!PREDICT(
  GET_PRESIGNED_URL(@pdf_inspections_stage, RELATIVE_PATH), 1)
  FROM DIRECTORY(@pdf_inspections_stage);
Copy

다음 예제에서는 paystubs 모델 빌드의 버전 1 에 대한 pdf_paystubs_stage 스테이지의 'paystubs/paystub01.pdf' 문서에서 정보를 추출합니다.

SELECT paystubs!PREDICT(
  GET_PRESIGNED_URL(@pdf_paystubs_stage, 'paystubs/paystub01.pdf'), 1);
Copy
언어: 한국어