CREATE EXTERNAL MODEL - Amazon Redshift
Pré-requisitosPrivilégios obrigatóriosControle de custosSintaxeParâmetros e configuraçõesParâmetros da função de inferência

CREATE EXTERNAL MODEL

Pré-requisitos referentes a CREATE EXTERNAL MODEL

Antes de usar a instrução CREATE EXTERNAL MODEL, conclua os pré-requisitos em Configuração de cluster para usar o Amazon Redshift ML. A seguir está um resumo de alto nível dos pré-requisitos.

  • Crie um cluster do Amazon Redshift com o Console de Gerenciamento da AWS ou a Interface de linha de comando da AWS (AWS CLI).

  • Anexe a política de Identity and Access Management (IAM) da AWS ao criar o cluster.

  • Para permitir que o Amazon Redshift e o Amazon Bedrock assumam o perfil para interagir com outros serviços, adicione a política de confiança apropriada ao perfil do IAM.

  • Habilite o acesso aos LLMs específicos que você deseja usar no console do Amazon Bedrock.

  • (Opcional) Se você encontrar exceções de controle de utilização provenientes do Amazon Bedrock, como Too many requests, please wait before trying again, mesmo com pequenas quantidades de dados, verifique as cotas em Cotas de serviço na conta do Amazon Bedrock. Verifique se a cota aplicada no nível da conta é pelo menos igual ao valor da cota padrão da AWS para as solicitações InvokeModel do modelo que você está usando.

Para obter detalhes sobre a função do IAM, a política de confiança e outros pré-requisitos, consulte Configuração de cluster para usar o Amazon Redshift ML.

Privilégios obrigatórios

Estes são os privilégios obrigatórios para CREATE EXTERNAL MODEL:

  • Superusuário

  • Usuários com o privilégio CREATE MODEL

  • Funções com privilégio GRANT CREATE MODEL

Controle de custos

O Amazon Redshift ML usa os recursos de cluster existentes para criar modelos de previsão. Portanato, você não precisa pagar a mais. No entanto, a AWS aplica cobranças ao uso do Amazon Bedrock com base no modelo selecionado. Para obter mais informações, consulte Custos de uso do Amazon Redshift ML.

Sintaxe de CREATE EXTERNAL MODEL

A seguir é apresentada a sintaxe completa da instrução CREATE EXTERNAL MODEL.

CREATE EXTERNAL MODEL model_name 
FUNCTION function_name
IAM_ROLE {default/'arn:aws:iam::<account-id>:role/<role-name>'}
MODEL_TYPE BEDROCK
SETTINGS (
   MODEL_ID model_id
   [, PROMPT 'prompt prefix']
   [, SUFFIX 'prompt suffix']
   [, REQUEST_TYPE {RAW|UNIFIED}]
   [, RESPONSE_TYPE {VARCHAR|SUPER}]
);

O comando CREATE EXTERNAL MODEL cria uma função de inferência usada para gerar conteúdo.

Esta é a sintaxe de uma função de inferência que CREATE EXTERNAL MODEL cria usando RAW como REQUEST_TYPE: 

SELECT inference_function_name(request_super) 
[FROM table];

Esta é a sintaxe de uma função de inferência que CREATE EXTERNAL MODEL cria usando UNIFIED como REQUEST_TYPE: 

SELECT inference_function_name(input_text, [, inference_config [, additional_model_request_fields]])
[FROM table];

Para ter informações sobre como usar a função de inferência, consulte Usar um modelo externo para a integração do Amazon Redshift ML com o Amazon Bedrock.

Parâmetros e configurações de CREATE EXTERNAL MODEL

Esta seção descreve os parâmetros e as configurações do comando CREATE EXTERNAL MODEL.

Parâmetros de CREATE EXTERNAL MODEL

model_name

O nome do modelo externo. O nome do modelo em um esquema deve ser exclusivo.

FUNCTION function_name (data_type [,...] )

O nome da função de inferência que cria CREATE EXTERNAL MODEL. Use a função de inferência para enviar solicitações ao Amazon Bedrock e recuperar texto gerado por ML.

IAM_ROLE { default | 'arn:aws:iam::<account-id>:role/<role-name>' }

O perfil do IAM que o Amazon Redshift usa para acessar o Amazon Bedrock. Para obter informações sobre a função do IAM, consulte Criar ou atualizar um perfil do IAM para a integração do Amazon Redshift ML com o Amazon Bedrock.

MODEL_TYPE BEDROCK

Especifica o tipo de modelo. O único valor válido é BEDROCK.

SETTINGS ( MODEL_ID model_id [,...] )

Especifica as configurações externas do modelo. Para obter detalhes, consulte a seção a seguir.

Configurações de CREATE EXTERNAL MODEL

MODEL_ID model_id

O identificador do modelo externo; por exemplo, anthropic.claude-v2. Para ter informações sobre IDs de modelo do Amazon Bedrock, consulte Amazon Bedrock model IDs.

PROMPT 'prompt prefix'

Especifica um prompt estático que o Amazon Redshift adiciona ao início de cada solicitação de inferência. Compatível apenas com o REQUEST_TYPE UNIFIED.

SUFFIX 'prompt suffix'

Especifica um prompt estático que o Amazon Redshift adiciona ao final de cada solicitação de inferência. Compatível apenas com o REQUEST_TYPE UNIFIED.

REQUEST_TYPE { RAW | UNIFIED }

Especifica o formato da solicitação enviada ao Amazon Bedrock. Entre os valores válidos estão os seguintes:

  • RAW: a função de inferência considera a entrada como um único valor super e sempre envia de volta um valor super. O formato do valor super é específico para o modelo do Amazon Bedrock selecionado. Super é um modelo de previsão que combina vários algoritmos para produzir uma previsão única e aprimorada.

  • UNIFIED: a função de inferência usa a API unificada. Todos os modelos têm uma interface unificada e consistente com o Amazon Bedrock. Isso funciona para todos os modelos que comportam mensagens. Esse valor é o padrão.

    Para ter mais informações, consulte a documentação da API Converse na documentação de API do Amazon Bedrock.

RESPONSE_TYPE { VARCHAR | SUPER }

Especifica o formato da resposta. Se REQUEST_TYPE for RAW, o RESPONSE_TYPE é obrigatório e o único valor válido é SUPER. Com relação a todos os outros valores de REQUEST TYPE, o valor padrão é VARCHAR e RESPONSE_TYPE é opcional. Entre os valores válidos estão os seguintes:

  • VARCHAR: o Amazon Redshift retorna somente a resposta de texto gerada pelo modelo.

  • SUPER: o Amazon Redshift envia de volta toda a resposta JSON gerada pelo modelo como um super. Isso inclui a resposta de texto, além de informações como o motivo da parada e o uso do token de entrada e saída do modelo. Super é um modelo de previsão que combina vários algoritmos para produzir uma previsão única e aprimorada.

Parâmetros da função de inferência CREATE EXTERNAL MODEL

Esta seção descreve os parâmetros válidos para a função de inferência criada pelo comando CREATE EXTERNAL MODEL.

Parâmetros da função de inferência CREATE EXTERNAL MODEL usando RAW como REQUEST_TYPE

Uma função de inferência criada com RAW como REQUEST_TYPE tem um argumento super de entrada e sempre envia de volta um tipo de dados super. A sintaxe do super de entrada segue a sintaxe da solicitação do modelo específico selecionado no Amazon Bedrock.

Parâmetros da função de inferência CREATE EXTERNAL MODEL usando UNIFIED como REQUEST_TYPE

input_text

O texto que o Amazon Redshift envia ao Amazon Bedrock.

inference_config

Um valor super que contém parâmetros opcionais que o Amazon Redshift envia ao Amazon Bedrock. Isso pode incluir o seguinte:

  • maxTokens

  • stopSequences

  • temperature

  • topP

Esses parâmetros são todos opcionais e diferenciam maiúsculas e minúsculas. Para ter informações sobre esses parâmetros, consulte InferenceConfiguration na Referência de API do Amazon Bedrock.