Consultando Ion con PartiQL en Amazon QLDB

Cuando consultas datos en AmazonQLDB, escribes declaraciones en formato PartiQL, pero QLDB devuelves los resultados en formato Amazon Ion. PartiQL está pensado para ser SQL compatible, mientras que Ion es una extensión de. JSON Esto genera diferencias sintácticas entre la forma de anotar los datos en las instrucciones de consulta y la forma en que se muestran los resultados de la consulta.

En esta sección se describen la sintaxis y la semántica básicas para ejecutar instrucciones PartiQL manualmente mediante QLDBla consola o QLDB el shell.

Sintaxis y semántica

Cuando se utiliza la QLDB consola o el QLDB shell para consultar datos de Ion, la sintaxis y la semántica fundamentales de PartiQL son las siguientes:

Literales

Los literales del lenguaje de consulta PartiQL corresponden a los tipos de datos de Ion, de la siguiente manera:

Ejemplo

A continuación, se muestra un ejemplo de la sintaxis de una instrucción INSERT con diversos 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`
}

Notación con acentos graves

PartiQL cubre todos los tipos de datos de Ion, por lo que puede escribir cualquier instrucción sin usar acentos graves. Sin embargo, hay casos en los que esta sintaxis literal de Ion puede hacer que sus instrucciones sean más claras y concisas.

Por ejemplo, para insertar un documento con valores de marca de tiempo y símbolo de Ion, puede escribir la siguiente instrucción utilizando únicamente la sintaxis de PartiQL.

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

Esto es bastante detallado, por lo que, en su lugar, puede utilizar acentos graves para simplificar la instrucción.

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

También puede incluir toda la estructura entre acentos graves para ahorrar algunas pulsaciones del teclado más.

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

'foo'

`foo`

Navegación de rutas

Al escribir sentencias de lenguaje de manipulación de datos (DML) o de consulta, puede acceder a los campos dentro de estructuras anidadas mediante pasos de ruta. PartiQL es compatible con la notación de puntos, que permite acceder a los nombres de campo de una estructura principal. En el siguiente ejemplo se accede al campo Model de un Vehicle principal.

Vehicle.Model

Para acceder a un elemento específico de una lista, puede utilizar el operador de corchetes para indicar un número ordinal de base cero. En el ejemplo siguiente se accede al elemento de SecondaryOwners con un número ordinal de 2. En otras palabras, este es el tercer elemento de la lista.

SecondaryOwners[2]

Uso de alias

QLDBadmite contenido y esquemas abiertos. Por lo tanto, cuando accede a campos concretos de una instrucción, la mejor manera de asegurarse de obtener los resultados esperados es utilizar alias. Por ejemplo, si no especifica un alias explícito, el sistema generará uno implícito para sus orígenes FROM.

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

Sin embargo, los resultados son impredecibles en caso de conflictos de nombres de campo. Si existe otro campo con el nombre VIN en una estructura anidada dentro de los documentos, los valores VIN devueltos por esta consulta pueden sorprenderle. Como práctica recomendada, escriba la siguiente instrucción en su lugar. Esta consulta declara v como un alias que se extiende por encima de la tabla Vehicle. La palabra clave AS es opcional.

SELECT v.VIN FROM Vehicle [ AS ] v

El uso de alias resulta especialmente útil cuando se crea una ruta a colecciones anidadas dentro de un documento. Por ejemplo, la siguiente instrucción declara o como un alias que abarca toda la colección VehicleRegistration.Owners.

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

En este caso, el carácter @ es técnicamente opcional. Sin embargo, indica de forma explícita que desea la estructura Owners dentro de VehicleRegistration y no una recopilación diferente denominada Owners (si existiera).

Especificación de PartiQL

Para obtener más información acerca del lenguaje de consultas de PartiQL, consulte la especificación de PartiQL.