AI_EXTRACT

AI_EXTRACT (Document AI 레거시 모델)

AI_EXTRACT 함수는 레거시 Document AI 모델을 사용해 파일에서 정보를 추출해요.

출처: AI_EXTRACT (Document AI 레거시 모델)

본문

AI_EXTRACT 함수는 레거시 Document AI 모델을 사용해 파일에서 정보를 추출해요.

폐기된 기능(Decommissioned Feature): Document AI와 model_build_name!PREDICT 메서드는 폐기되었어요. 자세한 내용은 Document AI 폐기(Document AI decommission)를 참조하세요.

구문 (Syntax)

AI_EXTRACT ( model => <model> ,
            file => <file> )

인자 (Arguments)

  • model => model — 추출에 사용할, Snowflake Model Registry에 저장된 Document AI Arctic-TILT 모델을 지정해요. 예: my_db.my_schema.my_model.
  • file => file — 추출할 FILE이에요.

반환 (Returns)

엔티티 추출 (Entity extraction)

{
  "error": null,
  "response": {
    "invoice_items": [
      "NEW CRUSHED VELVET DIVAN BED",
      "Vintage Radiator",
      "Solid Wooden Worktop",
      "Sienna Crushed Velvet Curtains"
    ],
    "invoice_number": "123/20",
    "tax_amount": "77.57",
    "total_amount": "465.43 GBP",
    "vendor_name": "UK Exports & Imports Ltd"
  }
}

테이블 추출 (Table extraction)

{
  "error": null,
  "response": {
    "table1": {
      "gross": ["10", "31", "10"],
      "item": ["apples", "banana", "pear"],
      "net": ["9", "30", "10"],
      "tax": ["1", "1", ""]
    },
    "table2": {
      "name": ["John", "Ana", "Lisa"],
      "surname": ["Smith", "Nixon", "Gonzales"]
    }
  }
}

접근 제어 요구 사항 (Access control requirements)

사용자는 SNOWFLAKE.CORTEX_USER 데이터베이스 역할이 부여된 역할을 사용해야 해요. 이 권한 부여에 대한 정보는 Cortex LLM privileges를 참조해요.

또한 모델에 대한 OWNERSHIP 권한이 있어야 해요.

사용 메모 (Usage notes)

  • 모델은 Snowflake Model Registry에 있어야 해요.
  • Document AI 모델은 100개 이하의 엔티티를 가져야 해요.
  • 명시적으로 설정하지 않으면 사용 가능한 최신 모델 버전이 기본적으로 사용돼요(Document AI UI에서 모델을 게시하거나 학습할 때 설정된 버전). 모델의 기본 버전을 설정하려면 다음 예제와 같이 ALTER MODEL 명령을 사용해요: 
    ALTER MODEL my_model SET DEFAULT_VERSION = new_version;
  • 신뢰 점수(Confidence scores)는 지원되지 않아요.
  • AI_EXTRACT는 토큰 기반 과금을 사용해요. Document AI 레거시 모델의 AI_EXTRACT 비용에 대한 자세한 내용은 Snowflake Service Consumption Table을 참조해요. 엔티티 추출 비용은 arctic-tilt-entity, 테이블 추출 비용은 arctic-tilt-table로 표시돼요.

지역 가용성 (Regional availability)

다음 지역에서 사용할 수 있어요:

  • AWS Canada (Central)
  • AWS EU (Frankfurt)
  • AWS EU (Ireland)
  • AWS US East (N. Virginia)
  • AWS US East (Ohio)
  • AWS US West (Oregon)
  • Azure Australia East (New South Wales)
  • Azure East US 2 (Virginia)
  • Azure Southeast Asia (Singapore)
  • Azure West Europe (Netherlands)
  • Azure West US 2 (Washington)

지역이 나열되지 않은 경우 교차 지역 추론(cross-region inference)을 사용해요.

예제 (Examples)

다음 예제는 Document AI 모델에 정의된 특징을 추출해요:

SELECT AI_EXTRACT(
  model => 'my_db.my_schema.my_model',
  file => TO_FILE('@files_db.files_schema.files', 'agreement.pdf')
);

다음 예제는 스테이지의 디렉터리에 있는 모든 파일에서 정보를 추출해요:

SELECT AI_EXTRACT(
  model => 'my_db.my_schema.my_model',
  file => TO_FILE('@db.schema.files', relative_path)
) FROM DIRECTORY (@db.schema.files);

Snowflake AI and ML을 참조해요.

더 알아보기 (Learn more)

  • Document AI
  • TO_FILE
  • 문자열 및 이진 함수 (String & binary functions)
  • AI 함수 (AI Functions)