Configuração de Document AI¶

Este tópico descreve a configuração da Document AI, incluindo a concessão de funções e privilégios necessários.

Para trabalhar com a Document AI:

Prepare um warehouse, um banco de dados e um esquema a serem usados com a Document AI.

A Snowflake recomenda a criação de um warehouse separado para a AI de documento para ajudar você a controlar os custos; por exemplo, o warehouse doc_ai_wh X-Small. Para obter mais informações, consulte Determinação do tamanho ideal do warehouse para Document AI.
Conceda as funções e privilégios necessários.

Para obter mais informações, consulte Controle de acesso da Document AI. Para obter exemplos de concessão de funções e privilégios, consulte Conceda as funções e privilégios necessários para usuários de Document AI.
Carregue os documentos para extração em um estágio interno ou externo.
Para criar um estágio interno, execute o comando CREATE STAGE, conforme mostrado no exemplo a seguir:
CREATE STAGE doc_ai_stage DIRECTORY = (ENABLE = TRUE) ENCRYPTION = (TYPE = 'SNOWFLAKE_SSE');
Copy
Para criar uma estágio externo, execute o comando CREATE STAGE conforme mostrado em Estágios externos.

Controle de acesso da Document AI¶

Para fornecer ao usuário acesso total à Document AI, é necessário seguir todos os passo a seguir:

Conceder a função de banco de dados SNOWFLAKE.DOCUMENT_INTELLIGENCE_CREATOR a uma função de conta e, em seguida, conceder a função de conta aos usuários.
Conceder os privilégios para preparar uma compilação de modelo de Document AI.
Conceder privilégios para criar pipelines de processamento e extrair informações usando Document AI.

Para saber mais sobre o modelo de privilégio Snowflake, consulte Visão geral do controle de acesso e Privilégios de controle de acesso.

A função de banco de dados SNOWFLAKE.DOCUMENT_INTELLIGENCE_CREATOR permite a criação da compilação de modelo Document AI, trabalhando em modelos de Document AI e usando SQL para extrair informações e trabalhar em pipelines de processamento de documentos.

Nota

Usar a função ACCOUNTADMIN não é suficiente para ter acesso a Document AI. Você deve conceder a função de banco de dados SNOWFLAKE.DOCUMENT_INTELLIGENCE_CREATOR e os privilégios necessários para sua função de conta.

Por exemplo, você pode criar uma função de conta doc_ai_role e conceder a função de banco de dados SNOWFLAKE.DOCUMENT_INTELLIGENCE_CREATOR à função doc_ai_role ou pode usar uma função de conta existente.

Privilégios de preparar um compilação de modelo Document AI¶

Para criar uma compilação de Document AI, carregue os documentos e teste e avaliar o modelo; é necessário usar uma função que tenha os seguintes privilégios:

Privilégio	Objeto
USAGE	Banco de dados que você planeja usar com Document AI
USAGE	Warehouse que você planeja usar com Document AI
OPERATE	Warehouse que você planeja usar com Document AI
GRANT CREATE SNOWFLAKE.ML.DOCUMENT_INTELLIGENCE	Esquema que você planeja usar com a Document AI
USAGE	Esquema que você planeja usar com a Document AI

Privilégios para criar pipelines de processamento e extrair informações usando Document AI¶

Para criar pipelines de processamento e extrair informações usando Document AI, você deve usar uma função que tenha todos os privilégios necessários para preparar uma compilação de Document AI, listados acima, e também os seguintes privilégios:

Privilégio	Objeto
CREATE STAGE	Esquema que você planeja usar com a Document AI
CREATE STREAM	Esquema que você planeja usar com a Document AI
CREATE TABLE	Esquema que você planeja usar com a Document AI
CREATE TASK	Esquema que você planeja usar com a Document AI
CREATE VIEW	Esquema que você planeja usar com a Document AI
EXECUTE TASK	Conta que você planeja usar para criar pipelines de processamento usando tarefas

Conceda as funções e privilégios necessários para usuários de Document AI¶

O exemplo a seguir descreve a concessão de todas as funções e privilégios necessários para trabalhar com a Document AI.

Nota

Antes de conceder as funções e privilégios necessários, confirme se um warehouse, um banco de dados e um esquema para a Document AI estão preparados.

Para criar a função doc_ai_role e conceder a função de banco de dados SNOWFLAKE.DOCUMENT_INTELLIGENCE_CREATOR para esta função, execute os seguintes comandos:

USE ROLE ACCOUNTADMIN;

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

Copy

Para criar um banco de dados, um esquema e um warehouse X-Small para usar com Document AI, execute os seguintes comandos:

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

Copy

Para conceder privilégios de uso e operação de warehouse à função doc_ai_role, execute os seguintes comandos:

GRANT USAGE, OPERATE ON WAREHOUSE doc_ai_wh TO ROLE doc_ai_role;

Copy

Para garantir que a função doc_ai_role possa usar o banco de dados e o esquema, execute os seguintes comandos:

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

Para garantir que a função doc_ai_role possa criar um estágio para armazenar os documentos para extração, execute os seguintes comandos:

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

Copy

Para garantir que a função doc_ai_role possa criar compilações de modelo (instâncias da classe DOCUMENT_INTELLIGENCE), execute o seguinte comando:

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

Copy

Para garantir que a função doc_ai_role possa criar pipelines de processamento, execute os seguintes comandos:

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

Para conceder a função doc_ai_role ao usuário doc_ai_user, execute o seguinte comando:

GRANT ROLE doc_ai_role TO USER doc_ai_user;

Copy