Aprimoramentos do ANSI JOIN e ANSI MERGE

Introdução

O suporte do N1QL para ANSI JOIN foi introduzido pela primeira vez na versão 5.5. Atualmente, há uma restrição no ANSI JOIN (versão 5.5 e 6.0) em que o lado direito de um ANSI JOIN deve ser um espaço-chave. Essa restrição será eliminada na versão 6.5.

O suporte do N1QL para a instrução MERGE atualmente usa a cláusula ON KEYS, semelhante à junção de pesquisa. A sintaxe ANSI MERGE será suportada na versão 6.5.

Aprimoramentos do ANSI JOIN

Na versão 6.5 do Couchbase Server, o N1QL adiciona suporte para expressão e subconsulta como lado direito de um ANSI JOIN. Anteriormente, nas versões 5.5 e 6.0, o lado direito de um ANSI JOIN deve ser um espaço-chave. Um erro será retornado se o lado direito de um ANSI JOIN não for um espaço-chave.

A restrição para o espaço-chave só existe nas versões 5.5 e 6.0, e só se aplica ao lado direito de um ANSI JOIN. O lado esquerdo de um ANSI JOIN pode ser um espaço-chave, uma expressão, uma subconsulta ou outra operação join/nest/unnest, desde que o ANSI JOIN não seja misturado com uma operação join/nest não ANSI.

Expressão como o lado direito de um ANSI JOIN

Uma expressão agora pode ser usada no lado direito do ANSI JOIN. Por exemplo:

Neste exemplo, uma matriz explícita de objetos é especificada como uma expressão no lado direito de um ANSI JOIN. Observe que quando uma expressão é usada no lado direito de um ANSI JOIN, a expressão deve ter um alias ("route" no exemplo acima, embora a palavra-chave AS seja opcional). 

Quando uma expressão é usada no lado direito de um ANSI JOIN, um operador ExpressionScan é usado para iterar pelo conjunto de resultados da expressão no plano de explicação:

Subconsulta como lado direito de um ANSI JOIN

Uma subconsulta também pode ser usada no lado direito do ANSI JOIN. Por exemplo:

Neste exemplo, uma subconsulta é usada no lado direito de um ANSI JOIN. Semelhante a uma expressão, quando uma subconsulta é usada no lado direito de um ANSI JOIN, a subconsulta também deve ter um alias ("route" no exemplo acima, embora a palavra-chave AS seja opcional).

Quando uma subconsulta é usada no lado direito de um ANSI JOIN, a explicação mostra o plano da própria subconsulta:

Quando uma subconsulta é usada como lado direito de um ANSI JOIN, ela não pode ser uma subconsulta correlacionada. Um erro será retornado se uma subconsulta correlacionada for usada no lado direito de um ANSI JOIN.

Junção de hash usada quando uma expressão ou uma subconsulta está no lado direito de um ANSI JOIN

Quando um espaço-chave é usado no lado direito de um ANSI JOIN, a junção de loop aninhado é o método de junção padrão e a junção de hash é considerada quando a dica USE HASH é especificada no espaço-chave do lado direito. Além disso, um índice secundário apropriado no espaço-chave é necessário quando a junção de loop aninhado é usada. Por outro lado, quando uma expressão ou uma subconsulta é usada no lado direito de um ANSI JOIN, como não há índice em uma expressão ou subconsulta, é mais eficiente usar uma junção de hash para realizar a junção. Uma junção de loop aninhado nesse caso é efetivamente uma junção cartesiana, já que o conjunto de resultados da expressão ou subconsulta precisa ser repetidamente verificado para cada documento externo. Como resultado, quando uma expressão ou subconsulta está no lado direito de um ANSI JOIN, a junção de hash é o método de junção padrão, mesmo sem a dica USE HASH especificada. Se a junção de hash não puder ser usada, por exemplo, se não houver predicado de junção de igualdade, se a dica USE NL for usada ou se a edição comunitária estiver sendo usada (a junção de hash só está disponível na edição empresarial), a junção de loop aninhado será considerada. Observando os arquivos de explicação acima para os casos de expressão e subconsulta como lado direito de um ANSI JOIN, você pode encontrar um operador HashJoin usado em ambos os arquivos de explicação.

Quando um espaço de chave é usado no lado direito de um ANSI JOIN, uma dica USE INDEX ou USE KEYS pode ser especificada no espaço de chave. Quando uma expressão ou uma subconsulta é usada no lado direito de um ANSI JOIN, não é possível especificar uma dica USE INDEX ou USE KEYS na expressão ou subconsulta, por motivos óbvios. A única dica disponível nesse caso é uma dica de união (USE HASH ou USE NL).

Suporte para ANSI NEST

O mesmo aprimoramento também se aplica ao ANSI NEST, ou seja, agora você pode usar uma expressão ou uma subconsulta como o lado direito de um ANSI NEST.

ANSI MERGE

Uma instrução MERGE permite que os documentos da "fonte" sejam mesclados no "destino", ou seja, quando uma correspondência é encontrada, o documento de destino pode ser atualizado; quando uma correspondência não é encontrada, um documento pode ser inserido no destino.

O conceito de "correspondência" é determinado pela condição de correspondência. Nas versões anteriores do Couchbase, o N1QL suporta apenas uma "correspondência" baseada na chave do documento, ou seja, a origem deve produzir uma chave de documento para o destino, para determinar se uma correspondência é encontrada (se o documento com essa chave de documento já existe no destino). Isso é obtido pela cláusula ON KEYS na sintaxe da instrução MERGE.

O comando MERGE com a cláusula ON KEYS é chamado de look-up merge. Isso é semelhante à sintaxe de união antes do suporte a ANSI JOIN, ou seja, look-up join, que também requer união na chave do documento e usa a cláusula ON KEYS. Portanto, uma extensão natural da instrução MERGE é usar a sintaxe ANSI MERGE, ou seja, usar a cláusula ON para especificar a condição de mesclagem, de modo que uma expressão arbitrária possa ser usada para determinar se existe ou não uma correspondência. O ANSI MERGE é compatível com o N1QL na versão 6.5 do servidor Couchbase.

Aqui está um exemplo de uma instrução ANSI MERGE:

Neste exemplo, a condição de mesclagem é especificada usando uma cláusula ON. Isso é muito semelhante à cláusula ON de um ANSI JOIN. De fato, internamente, a instrução ANSI MERGE usa ANSI JOIN com a mesma cláusula ON para determinar se existe uma correspondência para qualquer documento de origem.

A explicação para a declaração de mesclagem acima:

Na explicação, você pode ver um operador NestedLoopJoin que é usado para a operação ANSI JOIN (transformada internamente) entre a origem e o destino.

A dica de união pode ser especificada na fonte:

Neste exemplo, a dica USE HASH é especificada no aeroporto.

Tratamento de várias correspondências em ANSI MERGE

Na mesclagem de pesquisa, como a condição de mesclagem está na chave do documento, há apenas uma única correspondência de documento de destino potencial para cada documento de origem. No ANSI MERGE, como a condição de mesclagem agora é uma expressão arbitrária, pode haver várias correspondências de documentos de destino para cada documento de origem. Para cada ação de mesclagem especificada, a ação de mesclagem só pode ser executada no máximo uma vez para cada documento de origem. No caso de várias correspondências, se uma ação de mesclagem for tentada uma segunda vez para o mesmo documento de origem, um erro será retornado (código de erro 5320 ou 5330). Se esse erro for encontrado, a condição de mesclagem (cláusula ON) precisará ser refinada para evitar várias correspondências para o mesmo documento de origem.

Ação INSERT para ANSI MERGE

Na mesclagem de pesquisa, se uma ação INSERT for especificada, somente o documento que está sendo inserido será fornecido. Como a mesclagem de pesquisa exige uma correspondência na chave do documento e a ação INSERT só é acionada quando nenhuma correspondência é encontrada (ou seja, nenhum documento com essa chave de documento existe no destino), o documento recém-inserido simplesmente usará a mesma chave de documento. Para ANSI MERGE, isso não é mais verdade, pois não é mais necessário que uma chave de documento seja a condição de correspondência. Como resultado, quando uma ação INSERT é especificada, uma chave de documento também deve ser especificada como parte da ação INSERT. Por exemplo:

Em comparação, aqui está a sintaxe da ação INSERT para mesclagem de pesquisa:

em que é o documento a ser inserido.

Aqui está a sintaxe da ação INSERT para ANSI MERGE:

em que especifica a chave do documento para o documento recém-inserido e especifica o novo documento. Os dois são separados por uma vírgula.

Há duas formas que podem ser usadas, as palavras-chave KEY e VALUE são opcionais. Um novo par de parênteses também é necessário.

As outras ações de mesclagem (ação UPDATE, ação DELETE) permanecem as mesmas entre a mesclagem de pesquisa e a ANSI MERGE.

Resumo

Os aprimoramentos do ANSI JOIN e o suporte ao ANSI MERGE no Couchbase 6.5 aumentam a conformidade do N1QL com o ANSI e tornam o N1QL mais fácil de usar, especialmente para a migração de um banco de dados relacional.