QLDBDocumentos da Amazon - Banco de dados Amazon Quantum Ledger (AmazonQLDB)
Estrutura de documento IonMapeamento do tipo de PartiQL-IonID do documento

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

QLDBDocumentos da Amazon

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 armazena registros de dados como documentos, que são apenas struct objetos Amazon Ion inseridos em uma tabela. Para obter a especificação do Ion, consulte o GitHub site da Amazon Ion.

Estrutura de documento Ion

Por exemploJSON, QLDB os documentos são compostos por pares de nome-valor na estrutura a seguir.

{
  name1: value1,
  name2: value2,
  name3: value3,
  ...
  nameN: valueN
}

O nome é um token símbolo e os valores são irrestritos. Cada par nome-valor é chamado de campo. O valor de um campo pode ser qualquer um dos Tipos de dados de Ion, incluindo tipos de contêiner: estruturas aninhadas, listas e listas de estruturas.

Da mesma formaJSON, a struct é indicado por colchetes ({...}) e a list é indicado por colchetes (). [...] O exemplo a seguir é um documento dos dados de exemplo Começando a usar o QLDB console da Amazon que contém valores de vários tipos.

{
    VIN: "1N4AL11D75C109151",
    LicensePlateNumber: "LEWISR261LL",
    State: "WA",
    City: "Seattle",
    PendingPenaltyTicketAmount: 90.25,
    ValidFrom: 2017-08-21T,
    ValidTo: 2020-05-11T,
    Owners: {
        PrimaryOwner: { PersonId: "294jJ3YUoH1IEEm8GSabOs" },
        SecondaryOwners: [{ PersonId: "5Ufgdlnj06gF5CWcOIu64s" }]
    }
}
Importante

No Ion, aspas duplas denotam valores de string, e símbolos sem aspas representam nomes de campo. Porém, no PartiQL, aspas simples denotam tanto os strings quanto os nomes dos campos.

Essa diferença na sintaxe permite que a linguagem de consulta PartiQL SQL mantenha a compatibilidade e o formato de dados Amazon Ion mantenha a JSON compatibilidade. Para obter detalhes sobre a sintaxe e a semântica do partiQL em, consulte. QLDB Consultar o Ion com o PartiQL

Mapeamento do tipo de PartiQL-Ion

EmQLDB, o PartiQL estende o sistema SQL de tipos do Ion para cobrir o modelo de dados Ion. Esse mapeamento é descrito da seguinte forma:

  • SQLos tipos escalares são cobertos por seus equivalentes de íons. Por exemplo: .

    • CHAR e VARCHAR são sequências Unicode mapeadas para o tipo de íon string.

    • NUMBER mapeia para o tipo decimal de Ion.

  • O struct tipo de Ion é equivalente a uma SQL tupla, que tradicionalmente representa uma linha da tabela.

    • No entanto, com conteúdo aberto e sem esquema, as consultas que dependem da natureza ordenada de uma SQL tupla não são suportadas (como a ordem de saída de). SELECT *

  • Além de NULL, o partiQL tem um tipo MISSING. Essa é uma especialização NULL e indica a falta de um campo. Esse tipo é necessário porque os campos struct de Ion podem ser esparsos.

ID do documento

QLDBatribui uma ID de documento a cada documento que você insere em uma tabela. Todos os sistemas atribuídos IDs são identificadores universalmente exclusivos (UUID), cada um representado em uma string codificada em Base62 (por exemplo,). 3Qv67yjXEwB9SjmvkuG6Cp Para ter mais informações, consulte Único IDs na Amazon QLDB.

Cada revisão de documento é identificada exclusivamente por uma combinação do ID do documento e um número de versão baseado em zero.

O ID do documento e os campos de versões estão incluídos nos metadados do documento, que você pode consultar na visualização confirmada (a visualização definida pelo sistema de uma tabela). Para obter mais informações sobre exibições emQLDB, consulteConceitos principais. Para saber mais sobre metadados, consulte Consultar metadados do documento.