Referência de formato de dados Amazon Ion na Amazon QLDB - Banco de dados Amazon Quantum Ledger (AmazonQLDB)
O que é o Amazon Ion?Especificação de IonJSONcompatívelExtensões de JSONExemplo de texto IonAPIreferências

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á.

Referência de formato de dados Amazon Ion na Amazon QLDB

Importante

Aviso de fim do suporte: os clientes existentes poderão usar a Amazon QLDB até o final do suporte em 31/07/2025. Para obter mais detalhes, consulte Migrar um Amazon QLDB Ledger para o Amazon Aurora Postgre. SQL

A Amazon QLDB usa um modelo de notação de dados que unifica o Amazon Ion com um subconjunto de tipos partiQL. Esta seção fornece uma visão geral de referência do formato de dados do documento Ion, separada de sua integração com o partiQL.

Consultando o Ion com o PartiQL na Amazon QLDB

Para saber a sintaxe e a semântica da consulta de dados do Ion com o PartiQL in, QLDB consulte a referência do Consultar o Ion com o PartiQL Amazon PartiQL. QLDB

Para exemplos de código que consultam e processam dados de íons em um QLDB livro contábil, consulte Exemplos de código do Amazon Ion e. Como trabalhar com o Amazon Ion

Tópicos

O que é o Amazon Ion?

O Ion é um formato de serialização de dados hierárquico, de código aberto, ricamente tipado, autodescritivo e originalmente desenvolvido internamente na Amazon. É baseado em um modelo de dados abstrato que permite armazenar dados estruturados e não estruturados. É um superconjunto deJSON, o que significa que qualquer JSON documento válido também é um documento Ion válido. Este guia pressupõe um conhecimento prático básico de. JSON Se você ainda não estiver familiarizadoJSON, consulte Introdução JSON para obter mais informações.

Você pode anotar documentos Ion de forma intercambiável em formato de texto legível por humanos ou em formato codificado binário. Por exemploJSON, o formulário de texto é fácil de ler e escrever, suportando prototipagem rápida. A codificação binária é mais compacta e eficiente para persistir, transmitir e analisar. Um processador Ion pode transcodificar entre os dois formatos para representar exatamente o mesmo conjunto de estruturas de dados sem perda de dados. Esse atributo permite que os aplicativos otimizem a forma como processam dados para diferentes casos de uso.

nota

O modelo de dados Ion é estritamente baseado em valores e não oferece suporte a referências. Assim, o modelo de dados pode representar hierarquias de dados que podem ser aninhadas em profundidade arbitrária, mas não em gráficos direcionados.

Especificação de Ion

Para obter uma lista completa dos tipos de dados principais do Ion com descrições completas e detalhes de formatação de valores, consulte o documento de especificação do Ion no GitHub site da Amazon.

Para simplificar o desenvolvimento de aplicativos, o Amazon Ion fornece bibliotecas de clientes que processam dados do Ion para você. Para exemplos de código de casos de uso comuns para processamento de dados de íons, consulte o Amazon Ion Cookbook em GitHub.

JSONcompatível

Da mesma formaJSON, você compõe documentos do Amazon Ion com um conjunto de tipos de dados primitivos e um conjunto de tipos de contêineres definidos recursivamente. O Ion inclui os seguintes tipos JSON de dados tradicionais:

  • null: um valor genérico nulo (vazio) não digitado. Além disso, conforme descrito na seção a seguir, o Ion suporta um tipo nulo distinto para cada tipo primitivo.

  • bool: Valores boleanos

  • string: Literais de texto em Unicode

  • list: Coleções heterogêneas ordenadas de valores

  • struct: Coleções não ordenadas de pares nome-valor Por exemploJSON, struct permite vários valores por nome, mas isso geralmente é desencorajado.

Extensões de JSON

Tipos de números

Em vez do JSON number tipo ambíguo, o Amazon Ion define estritamente os números como um dos seguintes tipos:

  • int: Números inteiros assinados de tamanho arbitrário

  • decimal: Números reais codificados em decimal de precisão arbitrária

  • float: números de ponto flutuante codificados em binário (64 bits). IEEE

Ao analisar documentos, um processador Ion atribui tipos de números da seguinte forma:

  • int: Números sem expoente ou ponto decimal (por exemplo, 100200).

  • decimal: Números sem expoente ou ponto decimal (por exemplo, 0.00001, 200.0).

  • float: Números com um expoente, como notação científica ou notação eletrônica (por exemplo, 2e0, 3.1e-4).

Novos tipos de dados

O Amazon Ion adiciona os seguintes tipos de dados:

  • timestamp: Momentos de data/hora/fuso horário de precisão arbitrária

  • symbol: Átomos simbólicos Unicode (identificadores)

  • blob: Dados binários de codificação definida pelo usuário.

  • clob: Dados de texto de codificação definida pelo usuário

  • sexp: coleções ordenadas de valores com semântica definida pelo aplicativo.

Tipos nulos

Além do tipo nulo genérico definido porJSON, o Amazon Ion oferece suporte a um tipo nulo distinto para cada tipo primitivo. Isso indica falta de valor e, ao mesmo tempo, mantém um tipo de dados rigoroso.

null
null.null       // Identical to untyped null
null.bool
null.int
null.float
null.decimal
null.timestamp
null.string
null.symbol
null.blob
null.clob
null.struct
null.list
null.sexp

Exemplo de texto Ion

// Here is a struct, which is similar to a JSON object.
{
    // Field names don't always have to be quoted.
    name: "fido",
    
    // This is an integer.
    age: 7,
    
    // This is a timestamp with day precision.
    birthday: 2012-03-01T,
    
    // Here is a list, which is like a JSON array.
    toys: [
        // These are symbol values, which are like strings,
        // but get encoded as integers in binary.
        ball,
        rope
    ],
}

APIreferências