Após uma análise cuidadosa, decidimos descontinuar o Amazon Kinesis Data Analytics para aplicativos SQL:
1. A partir de **1º de setembro de 2025,** não forneceremos nenhuma correção de bug para aplicativos do Amazon Kinesis Data Analytics para SQL porque teremos suporte limitado para ele, devido à próxima descontinuação.
2. A partir **de 15 de outubro de 2025,** você não poderá criar novos aplicativos Kinesis Data Analytics para SQL.
3. Excluiremos as aplicações a partir de **27 de janeiro de 2026**. Você não poderá mais iniciar nem operar as aplicações do Amazon Kinesis Data Analytics para SQL. A partir dessa data, não haverá mais suporte ao Amazon Kinesis Data Analytics para SQL. Para obter mais informações, consulte [Descontinuação de aplicações do Amazon Kinesis Data Analytics para SQL](discontinuation.md).
As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Trabalho com o editor de esquema
O esquema do fluxo de entrada de um aplicativo Amazon Kinesis Data Analytics define a forma como os dados do fluxo são disponibilizados nas consultas SQL no aplicativo.
O esquema contém critérios de seleção para determinar qual parte da entrada de streaming será transformada em uma coluna de dados no stream de entrada no aplicativo. Essa entrada pode ser um dos seguintes itens:
+ Uma expressão JSONPath para fluxos de entrada JSON. JSONPath é uma ferramenta para consultar dados JSON.
+ Um número de coluna para fluxos de entrada em formato CSV (valores separados por vírgulas).
+ Um nome de coluna e um tipo de dados SQL para apresentar os dados no fluxo de dados do aplicativo. O tipo de dados também contém um tamanho de caractere ou dados binários.
O console tenta gerar o esquema usando [DiscoverInputSchema](API_DiscoverInputSchema.md). Se a descoberta do esquema apresentar falha ou retornar um esquema incorreto ou incompleto, você deverá editá-lo manualmente usando o editor de esquema.
## Tela principal do editor de esquema
A imagem a seguir mostra a tela principal do editor de esquema.
Você pode aplicar as seguintes edições ao esquema:
+ Adicionar uma coluna (1): talvez seja necessário adicionar uma coluna de dados se um item de dados não for detectado automaticamente.
+ Excluir uma coluna (2): você pode excluir dados do fluxo de origem se eles não forem necessários ao aplicativo. Essa exclusão não afeta os dados no fluxo de origem. Se os dados forem excluídos, eles simplesmente não serão disponibilizados no aplicativo.
+ Renomear uma coluna (3). Um nome de coluna não pode ficar em branco, deve ter mais de um único caractere e não deve conter palavras-chave SQL reservadas. O nome também deve atender aos critérios de nomenclatura dos identificadores SQL comuns: o nome deve começar com uma letra e conter apenas letras, sublinhados e dígitos.
+ Alterar o tipo de dados (4) ou o tamanho (5) de uma coluna: você pode especificar um tipo de dados compatível para uma coluna. Se você especificar um tipo de dados incompatível, a coluna será preenchida com NULL ou o fluxo do aplicativo não será preenchido. Nesse último caso, os erros serão gravados no fluxo de erros. Se você especificar um tamanho muito pequeno para uma coluna, os dados de entrada serão truncados.
+ Alterar os critérios de seleção de uma coluna (6): você pode editar a expressão JSONPath ou a ordem da coluna CSV usada para determinar a origem dos dados em uma coluna. Para alterar os critérios de seleção de um schema JSON, insira um novo valor para a expressão de caminho de linha. Um esquema CSV usa a ordem das colunas como critérios de seleção. Para alterar os critérios de seleção de um esquema CSV, altere a ordem das colunas.
## Edição de um esquema para uma origem de streaming
Se você precisar editar um esquema para uma origem de streaming, siga estas etapas.
**Para editar o esquema de uma origem de streaming**
1. Na página **Source**, escolha **Edit schema**.
1. Na página **Edit schema**, edite o esquema de origem.
1. Em **Format**, escolha **JSON** ou **CSV**. Para o formato JSON ou CSV, a codificação compatível é ISO 8859-1.
Para obter mais informações sobre como editar o esquema para o formato JSON ou CSV, consulte os procedimentos nas próximas seções.
### Edição de um esquema JSON
Você pode editar um esquema JSON usando as etapas a seguir.
**Para editar um esquema JSON**
1. No editor de esquema, escolha **Add column** para adicionar uma coluna.
Uma nova coluna aparece na primeira posição de coluna. Para alterar a ordem das colunas, selecione as setas para cima e para baixo ao lado do nome da coluna.
No caso de uma nova coluna, forneça as seguintes informações:
+ Em **Column name**, digite um nome.
Um nome de coluna não pode ficar em branco, deve ter mais de um único caractere e não deve conter palavras-chave SQL reservadas. Ele também deve atender aos critérios dos identificadores SQL comuns: deve começar com uma letra e conter apenas letras, sublinhados e dígitos.
+ Em **Column type**, digite um tipo de dados SQL.
Um tipo de coluna pode ser qualquer tipo de dados SQL compatível. Se o novo tipo de dados for CHAR, VARBINARY ou VARCHAR, especifique um tamanho de dados em **Length**. Para obter mais informações, consulte [Tipos de dados](https://docs.aws.amazon.com/kinesisanalytics/latest/sqlref/sql-reference-data-types.html).
+ Em **Linha de linha**, forneça um caminho de linha. Um caminho de linha é uma expressão JSONPath válida que é mapeada para um elemento JSON.
**nota**
O valor base **Row path** é o caminho para o pai de nível superior que contém os dados a serem importados. Por padrão, esse valor é **$**. Para obter mais informações, consulte `RecordRowPath` em `[JSONMappingParameters](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_JSONMappingParameters.html)`.
1. Para excluir uma coluna, escolha o ícone **x** ao lado do número da coluna.
1. Para renomear uma coluna, insira um novo nome em **Column name (Nome da coluna)**. O novo nome de coluna não pode ficar em branco, deve ter mais de um único caractere e não deve conter palavras-chave SQL reservadas. Ele também deve atender aos critérios dos identificadores SQL comuns: deve começar com uma letra e conter apenas letras, sublinhados e dígitos.
1. Para alterar o tipo de dados de uma coluna, escolha um novo tipo de dados em **Column type**. Se o novo tipo de dados for `CHAR`, `VARBINARY` ou `VARCHAR`, especifique um tamanho de dados em **Length (Comprimento)**. Para obter mais informações, consulte [Tipos de dados](https://docs.aws.amazon.com/kinesisanalytics/latest/sqlref/sql-reference-data-types.html).
1. Escolha **Save schema and update stream** para salvar as alterações.
O esquema modificado será exibido no editor e se parecerá com o seguinte.
Se o esquema tiver várias linhas, você poderá filtrar as linhas usando **Filter by column name**. Por exemplo, para editar nomes de coluna que começam com `P`, como uma coluna `Price`, insira `P` na caixa **Filter by column name (Filtrar por nome de coluna)**.
### Edição de um esquema CSV
Você pode editar um esquema CSV usando as etapas a seguir.
**Para editar um esquema CSV**
1. No editor de esquema, em **Row delimitador**, escolha o delimitador usado pelo fluxo de dados de entrada. Esse é o delimitador entre os registros de dados do fluxo, como um caractere de nova linha, por exemplo.
1. Em **Column delimiter**, escolha o delimitador usado pelo fluxo de dados de entrada. Esse é o delimitador entre os campos de dados do fluxo, como uma vírgula, por exemplo.
1. Para adicionar uma coluna, escolha **Add column**.
Uma nova coluna aparece na primeira posição de coluna. Para alterar a ordem das colunas, selecione as setas para cima e para baixo ao lado do nome da coluna.
No caso de uma nova coluna, forneça as seguintes informações:
+ Em **Column name (Nome de coluna)**, insira um nome.
Um nome de coluna não pode ficar em branco, deve ter mais de um único caractere e não deve conter palavras-chave SQL reservadas. Ele também deve atender aos critérios dos identificadores SQL comuns: deve começar com uma letra e conter apenas letras, sublinhados e dígitos.
+ Em **Column type (Tipo de coluna)**, insira um tipo de dados SQL.
Um tipo de coluna pode ser qualquer tipo de dados SQL compatível. Se o novo tipo de dados for CHAR, VARBINARY ou VARCHAR, especifique um tamanho de dados em **Length**. Para obter mais informações, consulte [Tipos de dados](https://docs.aws.amazon.com/kinesisanalytics/latest/sqlref/sql-reference-data-types.html).
1. Para excluir uma coluna, escolha o ícone **x** ao lado do número da coluna.
1. Para renomear uma coluna, insira um novo nome em **Column name (Nome da coluna)**. O novo nome de coluna não pode ficar em branco, deve ter mais de um único caractere e não deve conter palavras-chave SQL reservadas. Ele também deve atender aos critérios dos identificadores SQL comuns: deve começar com uma letra e conter apenas letras, sublinhados e dígitos.
1. Para alterar o tipo de dados de uma coluna, escolha um novo tipo de dados em **Column type**. Se o novo tipo de dados for CHAR, VARBINARY ou VARCHAR, especifique um tamanho de dados em **Length**. Para obter mais informações, consulte [Tipos de dados](https://docs.aws.amazon.com/kinesisanalytics/latest/sqlref/sql-reference-data-types.html).
1. Escolha **Save schema and update stream** para salvar as alterações.
O esquema modificado será exibido no editor e se parecerá com o seguinte.
Se o esquema tiver várias linhas, você poderá filtrar as linhas usando **Filter by column name**. Por exemplo, para editar nomes de coluna que começam com `P`, como uma coluna `Price`, insira `P` na caixa **Filter by column name (Filtrar por nome de coluna)**.