Consultando o Ion com o PartiQL na Amazon QLDB

Ao consultar dados na AmazonQLDB, você escreve declarações no formato partiQL, mas QLDB retorna os resultados no formato Amazon Ion. O partiQL foi projetado para ser SQL compatível, enquanto o Ion é uma extensão do. JSON Isso leva a diferenças sintáticas entre a forma como você anota os dados em suas instruções da consulta e a forma como os resultados da consulta são exibidos.

Esta seção descreve a sintaxe e a semântica básicas para executar instruções partiQL manualmente usando o QLDBconsole ou o shell. QLDB

Sintaxe e semântica

Ao usar o QLDB console ou o QLDB shell para consultar dados do Ion, veja a seguir a sintaxe e a semântica fundamentais do partiQL:

Literais

Os literais da linguagem de consulta partiQL correspondem aos tipos de dados Ion, da seguinte forma:

Exemplo

Veja a seguir um exemplo da sintaxe de uma instrução INSERT com vários tipos de Ion.

INSERT INTO VehicleRegistration VALUE
{
    'VIN' : 'KM8SRDHF6EU074761', --string
    'RegNum' : 1722, --integer
    'State' : 'WA',
    'City' : 'Kent',
    'PendingPenaltyTicketAmount' : 130.75, --decimal
    'Owners' : { --nested struct
        'PrimaryOwner' : { 'PersonId': '294jJ3YUoH1IEEm8GSabOs' },
        'SecondaryOwners' : [ --list of structs
            { 'PersonId' : '1nmeDdLo3AhGswBtyM1eYh' },
            { 'PersonId': 'IN7MvYtUjkp1GMZu0F6CG9' }
        ]
    },
    'ValidFromDate' : `2017-09-14T`, --Ion timestamp literal with day precision
    'ValidToDate' : `2020-06-25T`
}

Notação de acento grave

O partiQL abrange totalmente todos os tipos de dados Ion, para que você possa gravar qualquer instrução sem usar acentos graves. Porém, há casos em que essa sintaxe literal do Ion pode tornar suas instruções mais claras e concisas.

Por exemplo, para inserir um documento com valores de timestamp e símbolo Ion, você pode escrever a seguinte instrução usando somente a sintaxe partiQL.

INSERT INTO myTable VALUE
{
    'myTimestamp': to_timestamp('2019-09-04T'),
    'mySymbol': cast('foo' as symbol)
}

Isso é bastante detalhado, então, em vez disso, você pode usar acentos graves para simplificar sua instrução.

INSERT INTO myTable VALUE
{
    'myTimestamp': `2019-09-04T`,
    'mySymbol': `foo`
}

Você também pode colocar toda a estrutura em acentos graves para economizar mais algumas teclas.

INSERT INTO myTable VALUE
`{
    myTimestamp: 2019-09-04T,
    mySymbol: foo
}`

'foo'

`foo`

Navegação por caminhos

Ao escrever linguagem de manipulação de dados (DML) ou instruções de consulta, você pode acessar campos em estruturas aninhadas usando etapas de caminho. O PartiQL suporta anotação de pontos para acessas os nomes dos campos de uma estrutura principal. O exemplo a seguir acessa o campo Model de um Vehicle principal.

Vehicle.Model

Para acessar um elemento específico de uma lista, você pode usar o operador de colchetes para indicar um número ordinal baseado em zero. O exemplo a seguir acessa o elemento de SecondaryOwners com um número ordinal de 2. Em outras palavras, esse é o terceiro elemento da lista.

SecondaryOwners[2]

Aliases

QLDBoferece suporte a conteúdo e esquema abertos. Portanto, quando você está acessando campos específicos em uma instrução, a melhor maneira de garantir que você obtenha os resultados esperados é usar aliases. Por exemplo, se você não especificar um alias explícito, o sistema gera um implícito para suas fontes FROM.

SELECT VIN FROM Vehicle
--is rewritten to
SELECT Vehicle.VIN FROM Vehicle AS Vehicle

Mas os resultados são imprevisíveis para conflitos de nomes de campos. Se outro campo chamado VIN existir em uma estrutura aninhada nos documentos, os valores VIN retornados por essa consulta podem surpreendê-lo. Como prática recomendada, escreva a seguinte instrução em vez disso. Essa consulta declara v como um alias que varia sobre a tabela Vehicle. A palavra-chave AS é opcional.

SELECT v.VIN FROM Vehicle [ AS ] v

O uso de aliases é particularmente útil ao criar caminhos em coleções aninhadas em um documento. Por exemplo, a instrução a seguir declara o como um alias que abrange toda a coleção VehicleRegistration.Owners.

SELECT o.SecondaryOwners
FROM VehicleRegistration AS r, @r.Owners AS o

O caractere @ é tecnicamente opcional aqui. Mas isso indica explicitamente que você deseja a estrutura Owners em VehicleRegistration, não uma coleção com um nome Owners diferente (se houver).

Especificação PartiQL

Para obter mais informações sobre a linguagem de consulta PartiQL, consulte a Especificação PartiQL.