Cláusula SELECT (consulta NoSQL)

  • Artigo

APLICA-SE A: NoSQL

Cada consulta consiste numa SELECT cláusula e opcionalmente FROM e WHERE cláusulas, de acordo com as normas DO SQL anSI. Normalmente, a origem na FROM cláusula é enumerada e a WHERE cláusula aplica um filtro na origem para obter um subconjunto de itens JSON. Em SELECT seguida, a cláusula projeta os valores JSON pedidos na lista selecionar.

Sintaxe

SELECT <select_specification>  

<select_specification> ::=
      '*'
      | [DISTINCT] <object_property_list>
      | [DISTINCT] VALUE <scalar_expression> [[ AS ] value_alias]  
  
<object_property_list> ::=
{ <scalar_expression> [ [ AS ] property_alias ] } [ ,...n ]

Argumentos

Description
<select_specification> Propriedades ou valor a selecionar para o conjunto de resultados.
'*' Especifica que o valor deve ser obtido sem efetuar alterações. Especificamente, se o valor processado for um objeto, todas as propriedades são obtidas.
<object_property_list> Especifica a lista de propriedades a obter. Cada valor devolvido é um objeto com as propriedades especificadas.
VALUE Especifica que o valor JSON deve ser obtido em vez do objeto JSON completo. Este argumento, ao contrário <property_list> de não encapsula o valor projetado num objeto.
DISTINCT Especifica que devem ser removidos duplicados de propriedades projetadas.
<scalar_expression> Expressão que representa o valor a ser calculado. Para obter mais informações, veja a secção de expressões escalares para obter detalhes.

Exemplos

Este primeiro exemplo seleciona dois valores de cadeia estática e devolve uma matriz com um único objeto que contém ambos os valores. Uma vez que os valores não têm nome, é utilizado um número sequencial gerado para atribuir um nome ao campo json equivalente.

SELECT "Adventure", "Works"

[
  {
    "$1": "Adventure",
    "$2": "Works"
  }
]

Neste exemplo seguinte, a projeção JSON é utilizada para ajustar a estrutura exata e os nomes dos campos para o objeto JSON resultante. Aqui, é criado um objeto JSON com campos com o nome department e team. O objeto JSON externo ainda não tem nome, pelo que é utilizado um número gerado ($1) para atribuir um nome a este campo.

SELECT {
    department: "Sales",
    team: "Field sales"
}

[
  {
    "$1": {
      "department": "Sales",
      "team": "Field sales"
    }
  }
]

Este exemplo ilustra o aplanamento do conjunto de resultados do exemplo anterior para simplificar a análise. A VALUE palavra-chave é utilizada aqui para impedir a moldagem dos resultados noutro objeto JSON.

SELECT VALUE {
    department: "Sales",
    team: "Field sales"
}

[
  {
    "department": "Sales",
    "team": "Field sales"
  }
]

Neste exemplo, a VALUE palavra-chave é utilizada com uma cadeia estática para criar uma matriz de cadeias como resultado.

SELECT VALUE "Sales"

[
  "Sales"
]

Neste exemplo final, suponha que existe um contentor com dois itens com vários campos de diferentes tipos de dados.

[
  {
    "team": "Field sales",
    "identity": {
      "name": "Parker McLean"
    },
    "contact": [
      "206-555-0147"
    ]
  },
  {
    "team": "Field sales",
    "identity": {
      "name": "Beibit Shayakhmet"
    },
    "contact": [
      "206-555-0178"
    ]
  }
]

Esta consulta de exemplo final utiliza uma combinação de uma SELECT cláusula, a VALUE palavra-chave, uma FROM cláusula e a projeção JSON para executar uma consulta comum com os resultados transformados num objeto JSON para o cliente analisar.

SELECT VALUE {
    name: e.identity.name,
    team: e.team,
    phone: e.contact[0]
}
FROM
    employees e

[
  {
    "name": "Parker McLean",
    "team": "Field sales",
    "phone": "206-555-0147"
  },
  {
    "name": "Beibit Shayakhmet",
    "team": "Field sales",
    "phone": "206-555-0178"
  }
]

Observações

  • A SELECT * sintaxe só é válida se FROM a cláusula tiver declarado exatamente um alias. SELECT * fornece uma projeção de identidade, que pode ser útil se não for necessária nenhuma projeção. SELECT * só é válido se FROM a cláusula for especificada e introduzir apenas uma única origem de entrada.
  • Tanto SELECT <select_list> e SELECT * são "açúcar sintático" e podem ser expressos em alternativa através de instruções simples SELECT :
    • SELECT * FROM ... AS from_alias ... é equivalente a: SELECT from_alias FROM ... AS from_alias ....
    • SELECT <expr1> AS p1, <expr2> AS p2,..., <exprN> AS pN [other clauses...] é equivalente a: SELECT VALUE { p1: <expr1>, p2: <expr2>, ..., pN: <exprN> }[other clauses...].

Conteúdo relacionado