Amazon Redshift non supporterà più la creazione di nuovi Python UDFs a partire dalla Patch 198. Python esistente UDFs continuerà a funzionare fino al 30 giugno 2026. Per ulteriori informazioni, consulta il [post del blog](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/). 

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

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

**Topics**
+ [Prerequisiti per CREATE EXTERNAL MODEL](#r_create_external_model_prereqs)
+ [Privilegi richiesti](#r_simple_create_model-privileges)
+ [Controllo dei costi](#r_create_model_cost)
+ [Sintassi di CREATE EXTERNAL MODEL](#r_create_external_model_syntax)
+ [Parametri e impostazioni di CREATE EXTERNAL MODEL](#r_create_external_model_parameters_settings)
+ [Parametri della funzione di inferenza CREATE EXTERNAL MODEL](#r_create_external_model_if_parameters)

## Prerequisiti per CREATE EXTERNAL MODEL
<a name="r_create_external_model_prereqs"></a>

Prima di utilizzare l’istruzione CREATE MODEL, completa i prerequisiti descritti in [Configurazione del cluster per l'utilizzo di Amazon Redshift ML](getting-started-machine-learning.md#cluster-setup). Di seguito è riportato un riepilogo approfondito dei prerequisiti.
+ Crea un cluster Amazon Redshift con la console di AWS gestione o l'interfaccia a riga di AWS comando (CLI AWS ).
+ Allega la policy AWS Identity and Access Management (IAM) durante la creazione del cluster.
+ Per consentire ad Amazon Redshift e Amazon Bedrock di assumere il ruolo per interagire con altri servizi, aggiungi la seguente policy di attendibilità al ruolo IAM.
+ Abilita l'accesso allo specifico LLMs che desideri utilizzare dalla console Amazon Bedrock.
+ (Facoltativo) Se riscontri eccezioni di limitazione provenienti da Amazon Bedrock, ad esempio `Too many requests, please wait before trying again`, anche con piccole quantità di dati, controlla le quote nella sezione **Service Quotas** nell’account di Amazon Bedrock. Verifica che la quota applicata a livello di account sia almeno uguale al valore di quota AWS predefinito per **InvokeModel**le richieste per il modello che stai utilizzando.

Per maggiori dettagli sul ruolo IAM, sulla policy di attendibilità e su altri prerequisiti, consultare [Configurazione del cluster per l'utilizzo di Amazon Redshift ML](getting-started-machine-learning.md#cluster-setup).

## Privilegi richiesti
<a name="r_simple_create_model-privileges"></a>

Di seguito sono riportati i privilegi richiesti per CREATE EXTERNAL MODEL:
+ Superuser
+ Utenti con il privilegio CREATE MODEL
+ Ruoli con il privilegio GRANT CREATE MODEL

## Controllo dei costi
<a name="r_create_model_cost"></a>

 Amazon Redshift ML utilizza le risorse cluster esistenti per creare modelli di previsione, quindi non sono previsti costi aggiuntivi. Tuttavia, i AWS costi per l'utilizzo di Amazon Bedrock dipendono dal modello selezionato. Per ulteriori informazioni consulta [Costi per l'utilizzo di Amazon Redshift ML](https://docs.aws.amazon.com/redshift/latest/dg/cost.html). 

## Sintassi di CREATE EXTERNAL MODEL
<a name="r_create_external_model_syntax"></a>

Di seguito è riportata la sintassi completa dell’istruzione 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}]
);
```

Il comando `CREATE EXTERNAL MODEL` crea una funzione di inferenza da utilizzare per generare contenuti. 

Di seguito è riportata la sintassi di una funzione di inferenza che `CREATE EXTERNAL MODEL` crea utilizzando `REQUEST_TYPE` uguale a `RAW`: 

```
SELECT inference_function_name(request_super) 
[FROM table];
```

Di seguito è riportata la sintassi di una funzione di inferenza che `CREATE EXTERNAL MODEL` crea utilizzando `REQUEST_TYPE` uguale a `UNIFIED`: 

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

Per informazioni su come utilizzare una funzione di inferenza, consulta [Utilizzo di un modello esterno per l’integrazione di Amazon Redshift ML con Amazon Bedrock](machine-learning-br.md#machine-learning-br-use).

## Parametri e impostazioni di CREATE EXTERNAL MODEL
<a name="r_create_external_model_parameters_settings"></a>

Questa sezione descrive i parametri e le impostazioni del comando `CREATE EXTERNAL MODEL`.

**Topics**
+ [Parametri di CREATE EXTERNAL MODEL](#r_create_external_model_parameters)
+ [Impostazioni di CREATE EXTERNAL MODEL](#r_create_external_model_settings)

### Parametri di CREATE EXTERNAL MODEL
<a name="r_create_external_model_parameters"></a>

model\$1name  
Il nome del modello esterno. Il nome del modello in uno schema deve essere unico.

FUNCTION *function\$1name (data\$1type [,...] )*  
Il nome della funzione di inferenza creata da `CREATE EXTERNAL MODEL`. La funzione di inferenza viene utilizzata per inviare richieste ad Amazon Bedrock e recuperare il testo generato da ML.

IAM\$1ROLE * \$1 default \$1 'arn:aws:iam::<account-id>:role/<role-name>' \$1*  
Il ruolo IAM utilizzato da Amazon Redshift per accedere ad Amazon Bedrock. Per informazioni sul ruolo IAM, consulta [Creazione o aggiornamento di un ruolo IAM per l’integrazione di Amazon Redshift ML con Amazon Bedrock](machine-learning-br.md#machine-learning-br-iam).

MODEL\$1TYPE BEDROCK  
Specifica il tipo di modello. L’unico valore valido è `BEDROCK`.

SETTINGS ( MODEL\$1ID model\$1id [,...] )  
Specifica le impostazioni del modello esterno. Per informazioni dettagliate, consulta la sezione seguente.

### Impostazioni di CREATE EXTERNAL MODEL
<a name="r_create_external_model_settings"></a>

MODEL\$1ID model\$1id  
L’identificatore del modello esterno, ad esempio `anthropic.claude-v2`. Per informazioni sul modello Amazon Bedrock IDs, consulta il modello [Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/userguide/model-ids.html). IDs

PROMPT 'prompt prefix'  
Specifica un prompt statico che Amazon Redshift aggiunge all’inizio di ogni richiesta di inferenza. Supportato solo con `REQUEST_TYPE` uguale a `UNIFIED`.

SUFFIX 'prompt suffix'  
Specifica un prompt statico che Amazon Redshift aggiunge alla fine di ogni richiesta di inferenza. Supportato solo con `REQUEST_TYPE` uguale a `UNIFIED`.

REQUEST\$1TYPE \$1 RAW \$1 UNIFIED \$1  
Specifica il formato della richiesta inviata ad Amazon Bedrock. I valori validi includono quanto segue:  
+ **RAW**: la funzione di inferenza accetta l’input come un unico valore SUPER e restituisce sempre un valore SUPER. Il formato del valore SUPER è specifico del modello Amazon Bedrock selezionato. Un valore SUPER è un modello di previsione che combina più algoritmi per produrre un’unica previsione migliorata.
+ **UNIFIED**: la funzione di inferenza utilizza l’API unificata. Tutti i modelli hanno un’interfaccia unificata e coerente con Amazon Bedrock. Funziona per tutti i modelli che supportano i messaggi. Questo è il valore predefinito.

  Per ulteriori informazioni, consulta la [documentazione dell’API Converse](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_Converse.html) nella *documentazione dell’API Amazon Bedrock*.

RESPONSE\$1TYPE \$1 VARCHAR \$1 SUPER \$1  
Specifica il formato della risposta. Se il valore dell’impostazione `REQUEST_TYPE` è `RAW`, l’impostazione `RESPONSE_TYPE` è obbligatoria e l’unico valore valido è `SUPER`. Per tutti gli altri valori dell’impostazione `REQUEST TYPE`, il valore predefinito è `VARCHAR` e l’impostazione `RESPONSE_TYPE` è facoltativa. I valori validi includono quanto segue:  
+ **VARCHAR**: Amazon Redshift restituisce solo la risposta testuale generata dal modello.
+ **SUPER**: Amazon Redshift restituisce l’intera risposta JSON generata dal modello come super. Ciò include la risposta testuale e informazioni come il motivo dell’interruzione e l’utilizzo dei token di input e output del modello. Un valore SUPER è un modello di previsione che combina più algoritmi per produrre un’unica previsione migliorata. 

## Parametri della funzione di inferenza CREATE EXTERNAL MODEL
<a name="r_create_external_model_if_parameters"></a>

In questa sezione sono descritti i parametri validi per la funzione di inferenza creata dal comando `CREATE EXTERNAL MODEL`. 

### Parametri della funzione di inferenza CREATE EXTERNAL MODEL per `REQUEST_TYPE` uguale a `RAW`
<a name="r_create_external_model_if_parameters_raw"></a>

Una funzione di inferenza creata con `REQUEST_TYPE` uguale a `RAW` ha un argomento di input super e restituisce sempre un tipo di dati super. La sintassi dell’input super segue la sintassi della richiesta del modello specifico selezionato in Amazon Bedrock.

### Parametri della funzione di inferenza CREATE EXTERNAL MODEL per `REQUEST_TYPE` uguale a `UNIFIED`
<a name="r_create_external_model_if_parameters_unified"></a>

input\$1text  
Il testo che Amazon Redshift invia ad Amazon Bedrock.

inference\$1config  
Un valore super che contiene parametri facoltativi che Amazon Redshift invia ad Amazon Bedrock. Possono essere inclusi i seguenti:  
+ maxTokens
+ stopSequences
+ temperature
+ topP
Questi parametri sono tutti facoltativi e fanno distinzione tra maiuscole e minuscole. Per informazioni su questi parametri, consulta [ InferenceConfiguration](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InferenceConfiguration.html)*Amazon Bedrock API Reference.*