O Amazon Redshift não permitirá mais a criação de UDFs do Python a partir do Patch 198. As UDFs do Python existentes continuarão a funcionar normalmente até 30 de junho de 2026. Para ter mais informações, consulte a [publicação de blog ](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/). 

# CREATE EXTERNAL MODEL
<a name="r_create_external_model"></a>

**Topics**
+ [Pré-requisitos referentes a CREATE EXTERNAL MODEL](#r_create_external_model_prereqs)
+ [Privilégios obrigatórios](#r_simple_create_model-privileges)
+ [Controle de custos](#r_create_model_cost)
+ [Sintaxe de CREATE EXTERNAL MODEL](#r_create_external_model_syntax)
+ [Parâmetros e configurações de CREATE EXTERNAL MODEL](#r_create_external_model_parameters_settings)
+ [Parâmetros da função de inferência CREATE EXTERNAL MODEL](#r_create_external_model_if_parameters)

## Pré-requisitos referentes a CREATE EXTERNAL MODEL
<a name="r_create_external_model_prereqs"></a>

Antes de usar a instrução CREATE EXTERNAL MODEL, conclua os pré-requisitos em [Configuração de cluster para usar o Amazon Redshift ML](getting-started-machine-learning.md#cluster-setup). 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](getting-started-machine-learning.md#cluster-setup).

## Privilégios obrigatórios
<a name="r_simple_create_model-privileges"></a>

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
<a name="r_create_model_cost"></a>

 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](https://docs.aws.amazon.com/redshift/latest/dg/cost.html). 

## Sintaxe de CREATE EXTERNAL MODEL
<a name="r_create_external_model_syntax"></a>

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](machine-learning-br.md#machine-learning-br-use).

## Parâmetros e configurações de CREATE EXTERNAL MODEL
<a name="r_create_external_model_parameters_settings"></a>

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

**Topics**
+ [Parâmetros de CREATE EXTERNAL MODEL](#r_create_external_model_parameters)
+ [Configurações de CREATE EXTERNAL MODEL](#r_create_external_model_settings)

### Parâmetros de CREATE EXTERNAL MODEL
<a name="r_create_external_model_parameters"></a>

model\$1name  
O nome do modelo externo. O nome do modelo em um esquema deve ser exclusivo.

FUNCTION *function\$1name (data\$1type [,...] )*  
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\$1ROLE * \$1 default \$1 'arn:aws:iam::<account-id>:role/<role-name>' \$1*  
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](machine-learning-br.md#machine-learning-br-iam).

MODEL\$1TYPE BEDROCK  
Especifica o tipo de modelo. O único valor válido é `BEDROCK`.

SETTINGS ( MODEL\$1ID model\$1id [,...] )  
Especifica as configurações externas do modelo. Para obter detalhes, consulte a seção a seguir.

### Configurações de CREATE EXTERNAL MODEL
<a name="r_create_external_model_settings"></a>

MODEL\$1ID model\$1id  
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](https://docs.aws.amazon.com/bedrock/latest/userguide/model-ids.html).

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\$1TYPE \$1 RAW \$1 UNIFIED \$1  
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](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_Converse.html) na *documentação de API do Amazon Bedrock*.

RESPONSE\$1TYPE \$1 VARCHAR \$1 SUPER \$1  
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
<a name="r_create_external_model_if_parameters"></a>

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`
<a name="r_create_external_model_if_parameters_raw"></a>

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`
<a name="r_create_external_model_if_parameters_unified"></a>

input\$1text  
O texto que o Amazon Redshift envia ao Amazon Bedrock.

inference\$1config  
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](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InferenceConfiguration.html) na *Referência de API do Amazon Bedrock*.