Amazon Redshift ne prendra plus en charge la création de nouveaux Python à UDFs partir du patch 198. UDFs Le Python existant continuera de fonctionner jusqu'au 30 juin 2026. Pour plus d’informations, consultez le [ billet de blog ](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/).
Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# CREATE EXTERNAL MODEL
**Topics**
+ [Prérequis pour CREATE EXTERNAL MODEL](#r_create_external_model_prereqs)
+ [Privilèges requis](#r_simple_create_model-privileges)
+ [Contrôle des coûts](#r_create_model_cost)
+ [Syntaxe CREATE EXTERNAL MODEL](#r_create_external_model_syntax)
+ [Paramètres et réglages de CREATE EXTERNAL MODEL](#r_create_external_model_parameters_settings)
+ [Paramètres de la fonction d’inférence CREATE EXTERNAL MODEL](#r_create_external_model_if_parameters)
## Prérequis pour CREATE EXTERNAL MODEL
Avant d’utiliser l’instruction CREATE EXTERNAL MODEL, suivez les étapes requises détaillées dans [Configuration du cluster pour l’utilisation d’Amazon Redshift ML](getting-started-machine-learning.md#cluster-setup). Vous trouverez ci-dessous un résumé général des étapes requises.
+ Créez un cluster Amazon Redshift à l'aide de la console de AWS gestion ou de l'interface de ligne de AWS commande (AWS CLI).
+ Attachez la politique AWS Identity and Access Management (IAM) lors de la création du cluster.
+ Pour permettre à Amazon Redshift et Amazon Bedrock d’assumer le rôle afin d’interagir avec d’autres services, ajoutez la politique de confiance appropriée au rôle IAM.
+ Activez l'accès aux informations spécifiques LLMs que vous souhaitez utiliser depuis la console Amazon Bedrock.
+ (Facultatif) Si vous rencontrez des exceptions de limitation provenant d’Amazon Bedrock, par exemple `Too many requests, please wait before trying again`, même avec de petites quantités de données, vérifiez les quotas dans la section **Service Quotas** de votre compte Amazon Bedrock. Vérifiez que le quota appliqué au niveau du compte est au moins identique à la valeur de quota AWS par défaut pour les **InvokeModel**demandes relatives au modèle que vous utilisez.
Pour plus d’informations sur le rôle IAM, la politique d’approbation et d’autres prérequis, consultez [Configuration du cluster pour l’utilisation d’Amazon Redshift ML](getting-started-machine-learning.md#cluster-setup).
## Privilèges requis
Les privilèges suivants sont requis pour CREATE EXTERNAL MODEL :
+ Superuser
+ Utilisateurs disposant du privilège CREATE MODEL
+ Rôles avec le privilège GRANT CREATE MODEL
## Contrôle des coûts
Amazon Redshift ML utilise les ressources existantes du cluster pour créer des modèles de prédiction, de sorte que vous n’avez pas à payer de frais supplémentaires. Toutefois, les AWS frais d'utilisation d'Amazon Bedrock dépendent du modèle que vous sélectionnez. Pour obtenir plus d’informations, consultez [Costs for using Amazon Redshift ML](https://docs.aws.amazon.com/redshift/latest/dg/cost.html) (Coûts d’utilisation d’Amazon Redshift ML).
## Syntaxe CREATE EXTERNAL MODEL
Voici la syntaxe complète de l’instruction CREATE EXTERNAL MODEL.
```
CREATE EXTERNAL MODEL model_name
FUNCTION function_name
IAM_ROLE {default/'arn:aws:iam:::role/'}
MODEL_TYPE BEDROCK
SETTINGS (
MODEL_ID model_id
[, PROMPT 'prompt prefix']
[, SUFFIX 'prompt suffix']
[, REQUEST_TYPE {RAW|UNIFIED}]
[, RESPONSE_TYPE {VARCHAR|SUPER}]
);
```
La commande `CREATE EXTERNAL MODEL` crée une fonction d’inférence que vous utilisez pour générer du contenu.
Voici la syntaxe d’une fonction d’inférence que `CREATE EXTERNAL MODEL` crée à l’aide d’un `REQUEST_TYPE` de type `RAW` :
```
SELECT inference_function_name(request_super)
[FROM table];
```
Voici la syntaxe d’une fonction d’inférence que `CREATE EXTERNAL MODEL` crée à l’aide d’un `REQUEST_TYPE` de type `UNIFIED` :
```
SELECT inference_function_name(input_text, [, inference_config [, additional_model_request_fields]])
[FROM table];
```
Pour en savoir plus sur la façon d’utiliser la fonction d’interférence, consultez [Utilisation d’un modèle externe pour l’intégration d’Amazon Redshift ML à Amazon Bedrock](machine-learning-br.md#machine-learning-br-use).
## Paramètres et réglages de CREATE EXTERNAL MODEL
Cette section décrit les paramètres et les réglages de la commande `CREATE EXTERNAL MODEL`.
**Topics**
+ [Paramètres de CREATE EXTERNAL MODEL](#r_create_external_model_parameters)
+ [Réglages de CREATE EXTERNAL MODEL](#r_create_external_model_settings)
### Paramètres de CREATE EXTERNAL MODEL
model\$1name
Nom du modèle externe. Le nom du modèle d’un schéma doit être unique.
FUNCTION *function\$1name (data\$1type [,...] )*
Nom de la fonction d’inférence que `CREATE EXTERNAL MODEL` crée. Vous utilisez la fonction d’inférence pour envoyer des demandes à Amazon Bedrock et récupérer du texte généré par ML.
IAM\$1ROLE * \$1 default \$1 ’arn:aws:iam:::role/’ \$1*
Rôle IAM utilisé par Amazon Redshift pour accéder à Amazon Bedrock. Pour obtenir des informations sur le rôle IAM, consultez [Création ou mise à jour d’un rôle IAM pour l’intégration d’Amazon Redshift ML à Amazon Bedrock](machine-learning-br.md#machine-learning-br-iam).
MODEL\$1TYPE BEDROCK
Spécifie le type de modèle. La seule valeur valide est `BEDROCK`.
SETTINGS ( MODEL\$1ID model\$1id [,...] )
Spécifie les paramètres du modèle externe. Pour plus d’informations, consultez la section.
### Réglages de CREATE EXTERNAL MODEL
MODEL\$1ID model\$1id
L’identifiant du modèle externe, par exemple, `anthropic.claude-v2`. Pour plus d'informations sur le modèle Amazon Bedrock IDs, consultez le modèle [Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/userguide/model-ids.html). IDs
PROMPT ’prompt prefix’
Spécifie une invite statique qu’Amazon Redshift ajoute au début de chaque demande d’inférence. Compatible uniquement avec un `REQUEST_TYPE` de type `UNIFIED`.
SUFFIX ’prompt suffix’
Spécifie une invite statique qu’Amazon Redshift ajoute à la fin de chaque demande d’inférence. Compatible uniquement avec un `REQUEST_TYPE` de type `UNIFIED`.
REQUEST\$1TYPE \$1 RAW \$1 UNIFIED \$1
Spécifie le format de la demande envoyée à Amazon Bedrock. Les valeurs valides sont les suivantes :
+ **RAW** : la fonction d’inférence prend l’entrée comme une super valeur unique et renvoie toujours une super valeur. Le format de la super valeur est spécifique au modèle Amazon Bedrock sélectionné. Un super est un modèle de prédiction qui combine plusieurs algorithmes pour produire une seule prédiction améliorée.
+ **UNIFIED** : la fonction d’inférence utilise l’API unifiée. Tous les modèles disposent d’une interface unifiée et cohérente avec Amazon Bedrock. Cela fonctionne pour tous les modèles compatibles avec les messages. Cette valeur est celle par défaut.
Pour plus d’informations, consultez la [Documentation de l’API Converse](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_Converse.html) dans la *Documentation de l’API Amazon Bedrock*.
RESPONSE\$1TYPE \$1 VARCHAR \$1 SUPER \$1
Spécifie le format de la réponse. Si `REQUEST_TYPE` est de type `RAW`, `RESPONSE_TYPE` est requis et la seule valeur valide est `SUPER`. Pour toutes les autres valeurs `REQUEST TYPE`, la valeur par défaut est `VARCHAR` et `RESPONSE_TYPE` est facultatif. Les valeurs valides sont les suivantes :
+ **VARCHAR** : Amazon Redshift renvoie uniquement le texte de réponse généré par le modèle.
+ **SUPER** : Amazon Redshift renvoie l’intégralité de la réponse JSON générée par le modèle sous forme de super. Cela inclut la réponse textuelle et des informations telles que le motif de l’arrêt et l’utilisation du jeton d’entrée et de sortie du modèle. Un super est un modèle de prédiction qui combine plusieurs algorithmes pour produire une seule prédiction améliorée.
## Paramètres de la fonction d’inférence CREATE EXTERNAL MODEL
Cette section décrit les paramètres valides pour la fonction d’inférence créée par la commande `CREATE EXTERNAL MODEL`.
### Paramètres de la fonction d’inférence CREATE EXTERNAL MODEL pour `REQUEST_TYPE` de type `RAW`
Une fonction d’inférence créée avec un `REQUEST_TYPE` de type `RAW` possède un super argument d’entrée et renvoie toujours un super type de données. La syntaxe du super d’entrée suit la syntaxe de la demande du modèle spécifique sélectionné à partir d’Amazon Bedrock.
### Paramètres de la fonction d’inférence CREATE EXTERNAL MODEL pour `REQUEST_TYPE` de type `UNIFIED`
input\$1text
Le texte qu’Amazon Redshift envoie à Amazon Bedrock.
inference\$1config
Une super valeur qui contient des paramètres facultatifs qu’Amazon Redshift envoie à Amazon Bedrock. Il peut s’agir des éléments suivants :
+ maxTokens
+ stopSequences
+ temperature
+ topP
Ces paramètres sont tous facultatifs et tous sensibles à la casse. Pour plus d'informations sur ces paramètres, consultez le [ InferenceConfiguration](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InferenceConfiguration.html)manuel *Amazon Bedrock API Reference*.