문제 해결 Document AI¶
다음 시나리오는 Document AI 에서 작업 시 발생할 수 있는 문제를 해결하는 데 도움이 될 수 있습니다.
쿼리 추출이 동작하지 않습니다.¶
추출 쿼리 가 작동하려면 추출할 문서를 내부 또는 외부 스테이지에 저장해야 합니다. 내부 스테이지를 생성할 때 SNOWFLAKE_SSE 암호화 유형을 지정해야 합니다.
오류 |
문서 형식에 따라 다음 중 하나와 같은 오류가 발생할 수 있습니다. { "__processingErrors": [ "File extension does not match actual mime type. Mime-Type: application/octet-stream" ] }
{ "__processingErrors": [ "cannot identify image file <_io.BytesIO object at 0x7f8a800ba020>" ] }
|
|---|---|
원인 |
문서를 저장하는 내부 스테이지를 생성할 때 |
해결책 |
내부 스테이지 를 생성하려면 다음 예제와 같이 CREATE STAGE 명령을 실행합니다. CREATE STAGE doc_ai_stage
DIRECTORY = (ENABLE = TRUE)
ENCRYPTION = (TYPE = 'SNOWFLAKE_SSE');
|
미리 서명된 URL이 만료되었습니다.¶
스테이지 문서 중 미리 지정된 URL은 <model_build_name>!PREDICT 에 대한 필수 인자입니다. 미리 지정된 URL을 가져오려면 기본 만료 시간이 있는 GET_PRESIGNED_URL 함수를 호출합니다.
자세한 내용은 GET_PRESIGNED_URL 섹션을 참조하십시오.
오류 |
{ "__processingErrors": [ "Received HTTP 403 response for presigned URL. URL may be expired." ] }
|
|---|---|
원인 |
미리 서명된 URL이 만료되었습니다. |
해결책 |
1개의 쿼리에 포함된 문서 수를 줄이거나 만료 시간을 늘리십시오. 만료 시간 연장에 대한 자세한 내용은 GET_PRESIGNED_URL 섹션을 참조하십시오. |
1개의 쿼리에 문서가 너무 많습니다.¶
Document AI 에는 1개의 추출 쿼리 에서 처리되는 문서 수에 제한이 있습니다. 자세한 내용은 Document AI 의 알려진 제한 사항 섹션을 참조하십시오.
오류 |
{ "__processingErrors": [ "Query limit reached: too many documents in a single query." ] }
|
|---|---|
원인 |
1개의 쿼리로 너무 많은 문서의 처리를 시도했습니다. |
해결책 |
여러 개의 쿼리를 사용하여 문서를 처리합니다. |
문서가 특정 요구 사항을 충족하지 않습니다.¶
Document AI 를 사용하여 처리하는 문서는 특정 요구 사항을 충족해야 합니다. 자세한 내용은 Document AI 를 위한 문서 준비 섹션을 참조하십시오.
오류 |
다음 오류 중 하나가 발생할 수 있습니다. { "__processingErrors": [ "Page 0 size is larger than the limit. Actual: 1083 mm x 1384 mm. Maximum: 1200 mm x 1200 mm." ] }
{ "__processingErrors": [ "Document has too many pages. Actual: 150. Maximum: 125." ] }
{ "__processingErrors": [ "Image size is too small. Actual: 20x20 px. Minimum: 50x50 px." ] }
{ "__processingErrors": [ "Unsupported file format. Actual: csv. Supported: docx, eml, htm, html, jpeg, jpg, pdf, png, text, tif, tiff, txt." ] }
{ "__processingErrors": [ "File exceeds maximum size. Actual: 54096026 bytes. Maximum: 50000000 bytes." ] }
|
|---|---|
원인 |
처리하려는 문서가 Document AI 의 요구 사항을 충족하지 않습니다. 요구 사항에 대한 자세한 내용은 Document AI 를 위한 문서 준비 섹션을 참조하십시오. |
해결책 |
요구 사항을 충족하도록 문서를 준비합니다. |
Document AI 모델 빌드가 게시되지 않았습니다.¶
Document AI 를 사용하여 정보를 추출하려면 Document AI 모델 빌드가 게시되어 있어야 합니다. 모델을 훈련시키고 훈련 후에 새로운 데이터 값을 추가하지 않은 경우(새로운 질문을 하지 않은 경우) 모델 빌드를 게시할 필요가 없습니다.
오류 |
오류 메시지는 다음과 같이 시작합니다. Request failed for external function DOCUMENT_EXTRACT_FEATURES$V1 with remote service error: 422
|
|---|---|
원인 |
Document AI 모델 빌드가 게시되지 않았습니다. |
해결책 |
Document AI 모델 빌드를 게시합니다. 자세한 내용은 Document AI 모델 빌드 게시 섹션을 참조하십시오. |
필수 권한이 부여되지 않았거나 모델 빌드 이름이 중복되었습니다.¶
Document AI 모델 빌드를 생성하려면 역할에 필요한 권한을 부여하고 고유한 모델 빌드 이름을 선택해야 합니다.
필수 권한에 대한 자세한 내용은 Document AI 액세스 제어 섹션을 참조하십시오.
오류 |
Unable to create a build on the specified database and schema. Please check the documentation to learn more.
|
|---|---|
원인 |
가능한 원인:
|
해결책 |
|