Document AI 설정하기¶

이 항목에서는 필요한 역할 및 권한 부여를 포함하여 Document AI 설정에 대해 설명합니다.

Document AI 작업을 수행하려면:

Document AI 와 함께 사용할 웨어하우스, 데이터베이스, 스키마를 준비합니다.

Snowflake는 비용을 추적하는 데 도움이 되도록 Document AI를 위한 별도의 웨어하우스(예: doc_ai_wh X-Small 웨어하우스)를 만들 것을 권장합니다. 자세한 내용은 Document AI 에 대한 최적의 웨어하우스 크기 결정 섹션을 참조하십시오.
필요한 역할과 권한을 부여합니다.

자세한 내용은 Document AI 액세스 제어 섹션을 참조하십시오. 역할 및 권한 부여의 예는 Document AI 사용자에게 필요한 역할 및 권한 부여 섹션을 참조하십시오.
추출할 문서를 내부 스테이지 또는 외부 스테이지에 업로드합니다.
내부 스테이지 를 생성하려면 다음 예제와 같이 CREATE STAGE 명령을 실행합니다.
CREATE STAGE doc_ai_stage DIRECTORY = (ENABLE = TRUE) ENCRYPTION = (TYPE = 'SNOWFLAKE_SSE');
Copy
외부 스테이지 를 생성하려면 외부 스테이지 에서와 같이 CREATE STAGE 명령을 실행합니다.

Document AI 액세스 제어¶

사용자에게 Document AI 에 대한 전체 액세스 권한을 부여하려면 다음을 모두 수행해야 합니다.

SNOWFLAKE.DOCUMENT_INTELLIGENCE_CREATOR 데이터베이스 역할을 계정 역할에 부여한 다음 사용자에게 계정 역할을 부여합니다.
Document AI 모델 빌드를 준비할 수 있는 권한을 부여합니다.
처리 파이프라인을 생성하고 Document AI 를 사용하여 정보를 추출할 수 있는 권한을 부여합니다.

Snowflake 권한 모델에 대해 자세히 알아보려면 액세스 제어의 개요 및 액세스 제어 권한 섹션을 참조하십시오.

SNOWFLAKE.DOCUMENT_INTELLIGENCE_CREATOR 데이터베이스 역할은 Document AI 모델 빌드를 만들고, Document AI 모델에서 작업하고, SQL을 사용하여 정보를 추출하고 문서 처리 파이프라인에서 작업할 수 있게 해줍니다.

참고

ACCOUNTADMIN 역할을 사용하는 것만으로는 Document AI 에 액세스할 수 없습니다. 계정 역할에 SNOWFLAKE.DOCUMENT_INTELLIGENCE_CREATOR 데이터베이스 역할과 필요한 권한을 부여해야 합니다.

예를 들어, doc_ai_role 계정 역할을 생성하고 doc_ai_role 역할에 SNOWFLAKE.DOCUMENT_INTELLIGENCE_CREATOR 데이터베이스 역할을 부여하거나 기존 계정 역할을 사용할 수 있습니다.

Document AI 모델 빌드를 준비하기 위한 권한¶

Document AI 빌드를 만들고, 문서를 업로드하고, 모델을 테스트 및 평가하려면 다음 권한이 있는 역할을 사용해야 합니다.

권한	오브젝트
USAGE	Document AI 와 함께 사용할 데이터베이스
USAGE	Document AI 와 함께 사용할 웨어하우스
OPERATE	Document AI 와 함께 사용할 웨어하우스
GRANT CREATE SNOWFLAKE.ML.DOCUMENT_INTELLIGENCE	Document AI 와 함께 사용할 스키마
USAGE	Document AI 와 함께 사용할 스키마

처리 파이프라인을 생성하고 Document AI 를 사용하여 정보를 추출하기 위한 권한¶

Document AI 를 사용하여 처리 파이프라인을 만들고 정보를 추출하려면 위에 나열된 Document AI 빌드를 준비하는 데 필요한 모든 권한과 다음 권한이 있는 역할을 사용해야 합니다.

권한	오브젝트
CREATE STAGE	Document AI 와 함께 사용할 스키마
CREATE STREAM	Document AI 와 함께 사용할 스키마
CREATE TABLE	Document AI 와 함께 사용할 스키마
CREATE TASK	Document AI 와 함께 사용할 스키마
CREATE VIEW	Document AI 와 함께 사용할 스키마
EXECUTE TASK	작업을 사용하여 처리 파이프라인을 생성하는 데 사용할 계정

Document AI 사용자에게 필요한 역할 및 권한 부여¶

다음 예제에서는 Document AI 를 사용하여 작업하는 데 필요한 모든 역할과 권한을 부여하는 방법을 설명합니다.

참고

필요한 역할과 권한을 부여하기 전에 Document AI 에 대한 웨어하우스, 데이터베이스 및 스키마가 준비되었는지 확인합니다.

doc_ai_role 역할을 만들고 이 역할에 SNOWFLAKE.DOCUMENT_INTELLIGENCE_CREATOR 데이터베이스 역할을 부여하려면 다음 명령을 실행합니다.

USE ROLE ACCOUNTADMIN;

CREATE ROLE doc_ai_role;
GRANT DATABASE ROLE SNOWFLAKE.DOCUMENT_INTELLIGENCE_CREATOR TO ROLE doc_ai_role;

Copy

Document AI 에서 사용할 데이터베이스, 스키마, X-Small 웨어하우스를 생성하려면 다음 명령을 실행합니다.

CREATE DATABASE doc_ai_db;
CREATE SCHEMA doc_ai_db.doc_ai_schema;
CREATE WAREHOUSE doc_ai_wh;

Copy

웨어하우스 사용 및 운영 권한을 doc_ai_role 역할에 부여하려면 다음 명령을 실행합니다.

GRANT USAGE, OPERATE ON WAREHOUSE doc_ai_wh TO ROLE doc_ai_role;

Copy

doc_ai_role 역할이 데이터베이스와 스키마를 사용할 수 있도록 하려면 다음 명령을 실행합니다.

GRANT USAGE ON DATABASE doc_ai_db TO ROLE doc_ai_role;
GRANT USAGE ON SCHEMA doc_ai_db.doc_ai_schema TO ROLE doc_ai_role;

Copy

추출할 문서를 저장할 스테이지를 doc_ai_role 역할이 생성할 수 있도록 하려면 다음 명령을 실행합니다.

GRANT CREATE STAGE ON SCHEMA doc_ai_db.doc_ai_schema TO ROLE doc_ai_role;

Copy

doc_ai_role 역할이 모델 빌드(DOCUMENT_INTELLIGENCE 클래스의 인스턴스)를 생성할 수 있도록 하려면 다음 명령을 실행합니다.

GRANT CREATE SNOWFLAKE.ML.DOCUMENT_INTELLIGENCE ON SCHEMA doc_ai_db.doc_ai_schema TO ROLE doc_ai_role;

Copy

doc_ai_role 역할이 처리 파이프라인 을 생성할 수 있도록 하려면 다음 명령을 실행합니다.

GRANT CREATE STREAM, CREATE TABLE, CREATE TASK, CREATE VIEW ON SCHEMA doc_ai_db.doc_ai_schema TO ROLE doc_ai_role;
GRANT EXECUTE TASK ON ACCOUNT TO ROLE doc_ai_role;

Copy

doc_ai_user 사용자에게 doc_ai_role 역할을 부여하려면 다음 명령을 실행합니다.

GRANT ROLE doc_ai_role TO USER doc_ai_user;

Copy