Après mûre réflexion, nous avons décidé de mettre fin à Amazon Kinesis Data Analytics pour les applications SQL :
1. À compter du **1er septembre 2025,** nous ne fournirons aucune correction de bogue pour les applications Amazon Kinesis Data Analytics for SQL, car leur support sera limité, compte tenu de l'arrêt prochain.
2. À compter du **15 octobre 2025,** vous ne pourrez plus créer de nouvelles applications Kinesis Data Analytics for SQL.
3. Nous supprimerons vos candidatures à compter **du 27 janvier 2026**. Vous ne serez pas en mesure de démarrer ou d'utiliser vos applications Amazon Kinesis Data Analytics for SQL. Support ne sera plus disponible pour Amazon Kinesis Data Analytics for SQL à partir de cette date. Pour de plus amples informations, veuillez consulter [Arrêt d'Amazon Kinesis Data Analytics pour les applications SQL](discontinuation.md).
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.
# Utilisation de l'éditeur de schéma
Le schéma du flux d’entrée d’une application Amazon Kinesis Data Analytics définit la manière dont les données du flux sont mises à la disposition des requêtes SQL dans l’application.
Le schéma contient des critères de sélection permettant de déterminer la partie de l'entrée de streaming qui est transformée en colonne dans le flux d'entrée intégré à l'application. Cette entrée peut être l'une des suivantes :
+ JSONPath Expression pour les flux d'entrée JSON. JSONPath est un outil permettant d'interroger des données JSON.
+ Un numéro de colonne pour les flux d'entrée au format CSV.
+ Un nom de colonne et un type de données SQL pour présenter les données dans le flux de données intégré à l'application. Le type de données contient également une longueur pour les données de caractères ou les données binaires.
La console tente de générer le schéma à l'aide de [DiscoverInputSchema](API_DiscoverInputSchema.md). Si la découverte de schéma échoue ou retourne un schéma incorrect ou incomplet, vous devez modifier le schéma manuellement à l'aide de l'éditeur de schéma.
## Ecran principal de l'éditeur de schéma
La capture d'écran suivante montre l'écran principal de l'éditeur de schéma.
Vous pouvez appliquer les modifications suivantes au schéma :
+ Ajouter une colonne (1) : Il se peut que vous ayez besoin d'ajouter une colonne de données si un élément de données n'est pas détecté automatiquement.
+ Supprimer une colonne (2) : Vous pouvez exclure des données du flux source si votre application ne les exige pas. Cette exclusion n'affecte pas les données du flux source. Si des données sont exclues, elles ne sont tout simplement pas mises à la disposition de l'application.
+ Renommer une colonne (3) : Un nom de colonne ne peut pas être vide, doit comporter plus d'un caractère et ne doit pas contenir de mots réservés SQL. Il doit également respecter les critères de dénomination des identifiants ordinaires pour SQL : Le nom doit commencer par une lettre et contenir uniquement des lettres, des traits de soulignement et des chiffres.
+ Changer le type de données (4) ou la longueur (5) d'une colonne : Vous pouvez spécifier un type de données compatible pour une colonne. Si vous spécifiez un type de données incompatible, soit la colonne contiendra la valeur NULL soit le flux intégré à l'application n'est pas du tout rempli. Dans ce dernier cas, les erreurs seront écrites dans le flux d'erreurs. Si vous spécifiez une longueur pour une colonne qui est trop petite, les données entrantes seront tronquées.
+ Modifier les critères de sélection d'une colonne (6) : vous pouvez modifier l' JSONPath expression ou l'ordre des colonnes CSV utilisés pour déterminer la source des données d'une colonne. Pour modifier les critères de sélection d'un schéma JSON, saisissez une nouvelle valeur pour l'expression de chemin de la ligne. Un schéma CSV utilise l'ordre des colonnes comme critères de sélection. Pour modifier les critères de sélection d'un schéma CSV, changez l'ordre des colonnes.
## Modification du schéma d'une source de streaming
Si vous avez besoin de modifier le schéma d'une source de streaming, procédez comme suit.
**Pour modifier le schéma d'une source de streaming**
1. Sur la page **Source**, choisissez **Edit schema**.
1. Sur la page **Edit schema**, modifiez le schéma source.
1. Sous **Format**, choisissez **JSON** ou **CSV**. Pour le format JSON ou CSV, l'encodage pris en charge est ISO 8859-1.
Pour plus d'informations sur la modification du schéma JSON ou CSV, consultez les procédures des sections suivantes.
### Modification d'un schéma JSON
Vous pouvez modifier un schéma JSON en procédant comme suit.
**Pour modifier un schéma JSON**
1. Dans l'éditeur de schéma, choisissez **Add column** pour ajouter une colonne.
Une nouvelle colonne s'affiche en première position. Pour modifier l'ordre des colonnes, choisissez les flèches haut et bas en regard du nom de la colonne.
Fournissez les informations suivantes pour la nouvelle colonne :
+ Sous **Column name**, saisissez un nom.
Un nom de colonne ne peut pas être vide, doit comporter plus d'un caractère et ne doit pas contenir de mots réservés SQL. Il doit également respecter les critères de dénomination des identifiants ordinaires pour SQL : Le nom doit commencer par une lettre et contenir uniquement des lettres, des traits de soulignement et des chiffres.
+ Sous **Column type**, saisissez un type de données SQL.
Le type de colonne peut être n'importe quel type de données SQL pris en charge. Si le nouveau type de données est CHAR, VARBINARY ou VARCHAR, indiquez une longueur de données sous **Length**. Pour plus d'informations, consultez [Types de données](https://docs.aws.amazon.com/kinesisanalytics/latest/sqlref/sql-reference-data-types.html).
+ Sous **Row path**, indiquez un chemin de ligne. Un chemin de ligne est une JSONPath expression valide qui correspond à un élément JSON.
**Note**
La valeur **Row path** de base est le chemin vers le parent de premier niveau qui contient les données à importer. Cette valeur est **$** par défaut. Pour plus d’informations, consultez `RecordRowPath` dans `[JSONMappingParameters](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_JSONMappingParameters.html)`.
1. Pour supprimer une colonne, choisissez l'icône **X** en regard du numéro de la colonne.
1. Pour renommer une colonne, tapez son nouveau nom sous **Nom de la colonne**. Le nouveau nom de la colonne ne peut pas être vide, doit comporter plus d'un caractère et ne doit pas contenir de mots réservés SQL. Il doit également respecter les critères de dénomination des identifiants ordinaires pour SQL : Le nom doit commencer par une lettre et contenir uniquement des lettres, des traits de soulignement et des chiffres.
1. Pour changer le type de données d'une colonne, choisissez un nouveau type de données sous **Column type**. Si le nouveau type de données est `CHAR`, `VARBINARY` ou `VARCHAR`, indiquez une longueur de données sous **Length (Longueur)**. Pour plus d'informations, consultez [Types de données](https://docs.aws.amazon.com/kinesisanalytics/latest/sqlref/sql-reference-data-types.html).
1. Choisissez **Save schema and update stream** pour enregistrer vos modifications.
Le schéma modifié s'affiche dans l'éditeur et ressemble à l'exemple suivant.
Si votre schéma comporte plusieurs lignes, vous pouvez les filtrer à l'aide de **Filter by column name**. Par exemple, pour modifier les noms des colonnes débutant par `P` (colonne `Price` par exemple), saisissez `P` dans la zone **Filter by column name (Filtrer par nom de colonne)**.
### Modification d'un schéma CSV
Vous pouvez modifier un schéma CSV en procédant comme suit.
**Pour modifier un schéma CSV**
1. Dans l'éditeur de schéma, sous **Row delimiter**, choisissez le séparateur utilisé par votre flux de données entrantes. Il s'agit du séparateur utilisé entre les enregistrements de données de votre flux (par exemple, un caractère de nouvelle ligne).
1. Sous **Column delimiter**, choisissez le séparateur utilisé par votre flux de données entrantes. Il s'agit du séparateur utilisé entre les champs de données de votre flux (par exemple, une virgule).
1. Pour ajouter une colonne, choisissez **Add column**.
Une nouvelle colonne s'affiche en première position. Pour modifier l'ordre des colonnes, choisissez les flèches haut et bas en regard du nom de la colonne.
Fournissez les informations suivantes pour la nouvelle colonne :
+ Sous **Nom de la colonne**, saisissez un nom.
Un nom de colonne ne peut pas être vide, doit comporter plus d'un caractère et ne doit pas contenir de mots réservés SQL. Il doit également respecter les critères de dénomination des identifiants ordinaires pour SQL : Le nom doit commencer par une lettre et contenir uniquement des lettres, des traits de soulignement et des chiffres.
+ Sous **Type de colonne**, saisissez un type de données SQL.
Le type de colonne peut être n'importe quel type de données SQL pris en charge. Si le nouveau type de données est CHAR, VARBINARY ou VARCHAR, indiquez une longueur de données sous **Length**. Pour plus d'informations, consultez [Types de données](https://docs.aws.amazon.com/kinesisanalytics/latest/sqlref/sql-reference-data-types.html).
1. Pour supprimer une colonne, choisissez l'icône **X** en regard du numéro de la colonne.
1. Pour renommer une colonne, tapez son nouveau nom sous **Nom de la colonne**. Le nouveau nom de la colonne ne peut pas être vide, doit comporter plus d'un caractère et ne doit pas contenir de mots réservés SQL. Il doit également respecter les critères de dénomination des identifiants ordinaires pour SQL : Le nom doit commencer par une lettre et contenir uniquement des lettres, des traits de soulignement et des chiffres.
1. Pour changer le type de données d'une colonne, choisissez un nouveau type de données sous **Column type**. Si le nouveau type de données est CHAR, VARBINARY ou VARCHAR, indiquez une longueur de données sous **Length**. Pour plus d'informations, consultez [Types de données](https://docs.aws.amazon.com/kinesisanalytics/latest/sqlref/sql-reference-data-types.html).
1. Choisissez **Save schema and update stream** pour enregistrer vos modifications.
Le schéma modifié s'affiche dans l'éditeur et ressemble à l'exemple suivant.
Si votre schéma comporte plusieurs lignes, vous pouvez les filtrer à l'aide de **Filter by column name**. Par exemple, pour modifier les noms des colonnes débutant par `P` (colonne `Price` par exemple), saisissez `P` dans la zone **Filter by column name (Filtrer par nom de colonne)**.