format_schema
format_schema_message_name
format_schema.
Para manter a compatibilidade com o formato legado de format_schema (file_name:message_name):
- Se
format_schema_message_namenão for especificado, o nome da mensagem será inferido a partir da partemessage_namedo valor legado deformat_schema. - Se
format_schema_message_namefor especificado ao usar o formato legado, ocorrerá um erro.
format_schema_source
format_schema.
Valores possíveis:
- ‘file’ (padrão):
format_schemaé o nome de um arquivo de esquema localizado no diretórioformat_schemas. - ‘string’:
format_schemaé o conteúdo literal do esquema. - ‘query’:
format_schemaé uma consulta para obter o esquema. Quandoformat_schema_sourceé definido como ‘query’, as seguintes condições se aplicam: - A consulta deve retornar exatamente um valor: uma única linha com uma única coluna do tipo string.
- O resultado da consulta é tratado como o conteúdo do esquema.
- Esse resultado é armazenado em cache localmente no diretório
format_schemas. - Você pode limpar o cache local usando o comando:
SYSTEM DROP FORMAT SCHEMA CACHE FOR Files. - Depois de armazenadas em cache, consultas idênticas não são executadas novamente para buscar o esquema até que o cache seja limpo explicitamente
- Além dos arquivos de cache locais, as mensagens Protobuf também são armazenadas em cache na memória. Mesmo após limpar os arquivos de cache locais, o cache em memória deve ser limpo usando
SYSTEM DROP FORMAT SCHEMA CACHE [FOR Protobuf]para atualizar completamente o esquema. - Execute a consulta
SYSTEM DROP FORMAT SCHEMA CACHEpara limpar de uma só vez o cache dos arquivos e dos esquemas de mensagens Protobuf.