Skip to main content
Ces paramètres sont générés automatiquement à partir du code source.

​
format_schema

Ce paramètre est utile lorsque vous utilisez des formats qui nécessitent une définition de schéma, comme Cap’n Proto ou Protobuf. Sa valeur dépend du format.

​
format_schema_message_name

Spécifie le nom du message requis dans le schéma défini dans format_schema. Pour préserver la compatibilité avec le format format_schema legacy (file_name:message_name) :
  • Si format_schema_message_name n’est pas spécifié, le nom du message est déduit de la partie message_name de la valeur format_schema legacy.
  • Si format_schema_message_name est spécifié lors de l’utilisation du format legacy, une erreur est générée.

​
format_schema_source

Définit la source de format_schema. Valeurs possibles :
  • ‘file’ (par défaut) : format_schema correspond au nom d’un fichier de schéma situé dans le répertoire format_schemas.
  • ‘string’ : format_schema correspond au contenu littéral du schéma.
  • ‘query’ : format_schema est une requête permettant de récupérer le schéma. Lorsque format_schema_source est défini sur ‘query’, les conditions suivantes s’appliquent :
  • La requête doit renvoyer exactement une valeur : une seule ligne avec une seule colonne de type chaîne.
  • Le résultat de la requête est traité comme le contenu du schéma.
  • Ce résultat est mis en cache localement dans le répertoire format_schemas.
  • Vous pouvez vider le cache local à l’aide de la commande : SYSTEM DROP FORMAT SCHEMA CACHE FOR Files.
  • Une fois mis en cache, les requêtes identiques ne sont plus exécutées pour récupérer de nouveau le schéma tant que le cache n’est pas explicitement vidé.
  • En plus des fichiers du cache local, les messages Protobuf sont également mis en cache en mémoire. Même après avoir vidé les fichiers du cache local, le cache en mémoire doit être vidé à l’aide de SYSTEM DROP FORMAT SCHEMA CACHE [FOR Protobuf] pour actualiser complètement le schéma.
  • Exécutez la requête SYSTEM DROP FORMAT SCHEMA CACHE pour vider en une seule fois le cache des fichiers locaux et celui des schémas des messages Protobuf.
Dernière modification le 23 juillet 2026