DocumentDB SQL - Jointures

Dans les bases de données relationnelles, la clause Joins est utilisée pour combiner les enregistrements de deux tables ou plus dans une base de données, et la nécessité de joindre des tables est très importante lors de la conception de schémas normalisés. Puisque DocumentDB traite le modèle de données dénormalisé de documents sans schéma, le JOIN dans DocumentDB SQL est l'équivalent logique d'une «auto-jointure».

Considérons les trois documents comme dans les exemples précédents.

Voici le AndersenFamily document.

{ 
   "id": "AndersenFamily", 
   "lastName": "Andersen", 
	
   "parents": [ 
      { "firstName": "Thomas", "relationship":  "father" }, 
      { "firstName": "Mary Kay", "relationship":  "mother" } 
   ],
   
   "children": [ 
      { 
         "firstName": "Henriette Thaulow", 
         "gender": "female", 
         "grade": 5, 
         "pets": [ { "givenName": "Fluffy", "type":  "Rabbit" } ] 
      } 
   ], 
   
   "location": { "state": "WA", "county": "King", "city": "Seattle" }, 
   "isRegistered": true 
}

Voici le SmithFamily document.

{ 
   "id": "SmithFamily", 
	
   "parents": [ 
      { "familyName": "Smith", "givenName": "James" }, 
      { "familyName": "Curtis", "givenName": "Helen" } 
   ],
   
   "children": [ 
      {
         "givenName": "Michelle", 
         "gender": "female", 
         "grade": 1 
      },
		
      { 
         "givenName": "John", 
         "gender": "male", 
         "grade": 7,
			
         "pets": [ 
            { "givenName": "Tweetie", "type": "Bird" } 
         ] 
      } 
   ],
   
   "location": { 
      "state": "NY", 
      "county": "Queens", 
      "city": "Forest Hills" 
   },
   
   "isRegistered": true 
}

Voici le WakefieldFamily document.

{ 
   "id": "WakefieldFamily", 
	
   "parents": [ 
      { "familyName": "Wakefield", "givenName": "Robin" }, 
      { "familyName": "Miller", "givenName": "Ben" } 
   ],
   
   "children": [ 
      { 
         "familyName": "Merriam", 
         "givenName": "Jesse", 
         "gender": "female", 
         "grade": 6,
			
         "pets": [ 
            { "givenName": "Charlie Brown", "type": "Dog" },
            { "givenName": "Tiger", "type": "Cat" }, 
            { "givenName": "Princess", "type": "Cat" } 
         ] 
      },
		
      { 
         "familyName": "Miller", 
         "givenName": "Lisa", 
         "gender": "female", 
         "grade": 3,
			
         "pets": [ 
            { "givenName": "Jake", "type": "Snake" } 
         ] 
      } 
   ], 
   
   "location": { "state": "NY", "county": "Manhattan", "city": "NY" }, 
   "isRegistered": false 
}

Jetons un coup d'œil à un exemple pour comprendre le fonctionnement de la clause JOIN.

Voici la requête qui joindra le sous-document racine aux enfants.

SELECT f.id 
FROM Families f 
JOIN c IN f.children

Lorsque la requête ci-dessus est exécutée, elle produira la sortie suivante.

[ 
   { 
      "id": "WakefieldFamily" 
   },
	
   { 
      "id": "WakefieldFamily" 
   },
	
   { 
      "id": "SmithFamily" 
   },
	
   { 
      "id": "SmithFamily" 
   },
	
   { 
      "id": "AndersenFamily" 
   } 
]

Dans l'exemple ci-dessus, la jointure se situe entre la racine du document et la sous-racine des enfants, ce qui crée un produit croisé entre deux objets JSON. Voici certains points à noter -

  • Dans la clause FROM, la clause JOIN est un itérateur.

  • Les deux premiers documents WakefieldFamily et SmithFamily contiennent deux enfants. Par conséquent, le jeu de résultats contient également le produit croisé qui produit un objet distinct pour chaque enfant.

  • Le troisième document AndersenFamily ne contient qu'un seul enfant, il n'y a donc qu'un seul objet correspondant à ce document.

Jetons un coup d'œil au même exemple, mais cette fois, nous récupérons également le nom de l'enfant pour une meilleure compréhension de la clause JOIN.

Voici la requête qui joindra le sous-document racine aux enfants.

SELECT  
   f.id AS familyName, 
   c.givenName AS childGivenName, 
   c.firstName AS childFirstName 
FROM Families f  
JOIN c IN f.children

Lorsque la requête ci-dessus est exécutée, elle produit la sortie suivante.

[ 
   { 
      "familyName": "WakefieldFamily", 
      "childGivenName": "Jesse" 
   },
	
   { 
      "familyName": "WakefieldFamily", 
      "childGivenName": "Lisa" 
   },
	
   { 
      "familyName": "SmithFamily", 
      "childGivenName": "Michelle" 
   },
	
   { 
      "familyName": "SmithFamily", 
      "childGivenName": "John" 
   },
	
   { 
      "familyName": "AndersenFamily", 
      "childFirstName": "Henriette Thaulow" 
   } 
]