Utilizar associações em expressões de caminho

Quando uma entidade de visão CDS lê a partir de uma entidade com associações expostas, existem duas possibilidades:

Propagando a associação

Ao adicionar o nome da associação à lista de elementos, a associação também se torna visível para os consumidores dessa visão. No exemplo, a associação _Department é definida e exposta na entidade de visão R_Employee. Visualizar entidade C_Employee lê de R_Employee e propaga associação _Department.

Usando a associação

Ao adicionar um sinal de período (.) e um nome de elemento após o nome da associação, a associação é usada para ler dados do destino de associação. Esse tipo de uso é chamado de Expressão de caminho. No exemplo, o destino da associação _Department é a entidade de visão CDS C_Department. A entidade de visão CDS C_Employee utiliza uma expressão de caminho para ler o campo DepmentDesignation do destino de associação e o adiciona à sua própria lista de elementos.

No nível do banco de dados, uma expressão de caminho é convertida em uma junção da origem da associação e do destino da associação. Isso se torna visível na função Mostrar instrução SQL Create do editor.

No exemplo, a expressão de caminho _Department.DepmentDesignation leva a um join de visões SQL R_EMPLOYEE e R_DEPARTMENT no banco de dados. A condição ON para o join é derivada da condição ON da associação.

É importante ressaltar que o join no nível do banco de dados só é construído quando a associação é utilizada em uma expressão de caminho. Definir, expor e propagar uma associação não leva a uma junção. Esse recurso de associações às vezes é referido como Join on Demand.

Vejamos um exemplo novamente: mesmo que a entidade de visão CDS R_Employee defina e exponha a associação _Department e a entidade de visão CDS C_Employee propaga essa associação, a visão SQL correspondente C_EMPLOYEE lê somente a partir da visão SQL R_EMPLOYEE.

Até agora, discutimos expressões de caminho com uma associação, apenas. Mas você também pode criar expressões de caminho mais longas encadeando várias associações.

Aqui está um exemplo: a entidade de visão CDS R_Employee expõe a associação _Department, que tem a entidade de visão CDS R_Department como destino. Este destino expõe outra associação _Head, apontando de volta para R_Employee, mas lendo o empregado que é chefe do respectivo departamento. Caminho expressão _Department._Head.LastName lê o sobrenome do chefe do departamento ao qual um empregado está atribuído. A junção longa e complicada de três fontes de dados é gerada automaticamente.

Na maioria das vezes, quando uma entidade de visão CDS define uma associação, ela a expõe a seus consumidores. No entanto, também pode utilizar a associação, diretamente, em vez de ou além de expô-la.

Chamamos isso de uso ad-hoc de associações. No exemplo, a entidade de visão CDS R_Employee define a associação _Department. Em vez de expor a associação, ela a utiliza diretamente em uma expressão de caminho para recuperar a designação do departamento relacionado.

No caso de uma utilização ad hoc, a junção é criada imediatamente na visão SQL para essa entidade de visão CDS.

Quando você utiliza uma associação em uma expressão de caminho, a cardinalidade pode influenciar a verificação de sintaxe. O editor exibe avisos e até mesmo erros para a utilização incorreta de associações "para muitos", ou seja, associações para as quais a cardinalidade tem um máximo maior que 1.

Em expressões de caminho na cláusula WHERE da definição de visão, a utilização de associações "para muitas" não é permitida e leva a um erro de sintaxe.

Na lista de elementos, são permitidas associações "para muitos", mas o editor exibe um aviso, indicando que essa expressão de caminho pode modificar o número de conjuntos de resultados.

O que significa este aviso? Imagine que suas tabelas contenham apenas 1 departamento com 5 funcionários. Sem a expressão de caminho, a visão CDS C_Department retorna exatamente 1 conjunto de dados. Em seguida, você adiciona a expressão de caminho com a associação "para muitos" _Employee à lista de elementos. Depois disso, a mesma visão retorna 5 conjuntos de dados, um para cada empregado. Isso pode ser enganoso para os consumidores da visão C_Department porque eles esperam um conjunto de dados para cada departamento.

Uma forma de usar uma associação "para muitos" corretamente é colocar a expressão de caminho dentro de uma agregação. A cláusula GROUP-BY-, que é obrigatória para agregações, garante que o número de conjuntos de dados permanece o mesmo. No exemplo, a entidade de visão CDS C_Department ainda retorna um conjunto de dados por departamento e não um conjunto de dados por empregado.

Quando você usa uma associação em uma expressão de caminho, pode adicionar filtros para restringir os conjuntos de dados do destino de associação. A condição de filtro é colocada em um par de colchetes ([ ]) imediatamente após o nome da associação. Como em uma cláusula WHERE, você pode usar operadores relacionais e operadores booleanos AND, OR, NOT. O lado esquerdo de uma condição deve ser um campo do destino da associação. Para o lado direito, há mais flexibilidade. Entre outras coisas, você pode utilizar campos do destino de associação, literais, funções integradas, etc.

No exemplo, existem duas expressões de caminho, uma sem uma condição de filtro e a outra com condição de filtro OccupiedSeats > MaximumSeats. Enquanto a primeira expressão de caminho procura o primeiro voo associado a uma conexão de voo, a segunda expressão de caminho restringe a pesquisa a voos ocupados, ou seja, voos em que o número de assentos ocupados excede o número de assentos disponíveis.

Tecnicamente, a condição de filtro é adicionada à condição ON da junção gerada no nível do banco de dados.

Vejamos a instrução SQL create para nosso exemplo: a primeira junção em nosso exemplo pertence à expressão path sem o filtro. A condição ON compara AIRLINEID, CONNECTIONID e o campo de cliente MANDT. A segunda junção pertence à expressão de caminho com o filtro. Você consegue identificar a condição adicional da expressão de caminho filtrada?

Quando você filtra uma associação que tem uma cardinalidade com máx. > 1, pode acontecer que, depois de aplicar o filtro, permaneça somente uma entrada do destino de associação. O filtro transforma a associação "para muitos" em uma associação "para um". Em uma situação desse tipo, você deve adicionar "1: " na frente da condição do filtro para documentar a cardinalidade modificada da associação.

Neste exemplo, a entidade de visão CDS I_Currency define e expõe a associação _Text, que é uma associação "para muitos", retornando nomes de moeda em diferentes idiomas. Sem um filtro, a associação leria o nome de uma moeda em todos os idiomas atualizados no sistema. No entanto, as duas expressões de caminho com um filtro leem somente um nome de moeda, em inglês ou em alemão.

Como vimos anteriormente, a verificação de sintaxe emite avisos e erros quando usamos uma associação "para muitos" em uma expressão de caminho que está fora de uma agregação. Mas o que acontece se um filtro garantir que existe apenas um registro? A verificação de sintaxe ainda emite os avisos e erros? Sim, ele faz, porque não pode saber que o filtro transforma a associação "para muitos" em uma associação "para um". Podemos documentar isso adicionando "1:" dentro dos colchetes, antes da condição de filtro. No exemplo, existe um aviso de sintaxe para a expressão de caminho com o filtro Language = 'E'. Mas não existe nenhum aviso de sintaxe para a expressão de caminho com o filtro 1: Language = 'D'.

Outra forma de usar associações expostas são as expressões de caminho no ABAP SQL. O conceito é exatamente o mesmo que no CDS, mas a sintaxe é ligeiramente diferente.

As diferenças de sintaxe mais importantes são as seguintes:

Prefixo de associação

Nas expressões de caminho ABAP SQL, as associações devem ser escapadas com uma barra invertida (\).

Seletor de elementos

Em expressões de caminho CDS, um sinal de ponto (.) é utilizado como separador entre o nome da associação e o nome do elemento. No ABAP SQL, o sinal do período não é adequado porque encerraria a instrução. Portanto, no ABAP SQL, um hífen é usado como seletor de elementos.

Vejamos um exemplo: esta instrução SELECT ABAP SQL lê a partir da entidade de visão CDS /DMO/I_Connection_R que expõe uma associação _Airline. A última expressão na lista FIELDS é uma expressão de caminho para ler o nome do elemento a partir do destino de associação /DMO/I_Carrier.

Outra diferença de sintaxe está relacionada a associações encadeadas. Quando uma expressão de caminho contém uma sequência de associações, não existe um separador dedicado. Em que no CDS as associações são separadas por um sinal de ponto (.), elas se seguem diretamente no ABAP SQL. No entanto, considere que cada nome de associação precisa de uma barra invertida (\) como prefixo.

Neste exemplo, o destino da associação _Airline expõe uma associação _Currency que retorna detalhes para a moeda local da companhia aérea. A expressão \_Airline\_Currency-CurrencyISOCode lê o código ISO para a moeda local da companhia aérea que opera a conexão de voo.

No ABAP SQL, as condições de filtro são adicionadas entre colchetes, como no CDS. No entanto, para indicar uma cardinalidade, é usada uma sintaxe totalmente diferente. Em vez de "1:", você tem que adicionar palavras-chave MANY TO ONE WHERE. Existem várias outras opções, como ONE TO ONE WHERE e MANY TO MANY WHERE. Consulte a documentação de palavra-chave ABAP para obter detalhes.