DocumentDB SQL-사용자 정의 함수

DocumentDB SQL은 사용자 정의 함수 (UDF)를 지원합니다. UDF는 작성할 수있는 또 다른 종류의 JavaScript 함수이며 예상대로 작동합니다. 쿼리에서 참조 할 수있는 사용자 지정 비즈니스 논리로 쿼리 언어를 확장하는 UDF를 만들 수 있습니다.

DocumentDB SQL 구문은 이러한 UDF를 사용하는 사용자 지정 응용 프로그램 논리를 지원하도록 확장되었습니다. UDF는 DocumentDB에 등록 된 다음 SQL 쿼리의 일부로 참조 될 수 있습니다.

이 예에 대해 다음 세 가지 문서를 고려해 보겠습니다.

AndersenFamily 문서는 다음과 같습니다.

{ 
   "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 
}

SmithFamily 문서는 다음과 같습니다.

{ 
   "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 
}

WakefieldFamily 문서는 다음과 같습니다.

{ 
   "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 
}

간단한 UDF를 만드는 예제를 살펴 보겠습니다.

다음은 구현입니다 CreateUserDefinedFunctions.

private async static Task CreateUserDefinedFunctions(DocumentClient client) { 
   Console.WriteLine(); 
   Console.WriteLine("**** Create User Defined Functions ****"); 
   Console.WriteLine();  
	
   await CreateUserDefinedFunction(client, "udfRegEx");  
}

udfRegEx가 있고 CreateUserDefinedFunction에서 로컬 파일에서 JavaScript 코드를 가져옵니다. 새 UDF에 대한 정의 개체를 구성하고 다음 코드와 같이 컬렉션의 SelfLink 및 udfDefinition 개체를 사용하여 CreateUserDefinedFunctionAsync를 호출합니다.

private async static Task<UserDefinedFunction>
CreateUserDefinedFunction(DocumentClient client, string udfId) { 
   var udfBody = File.ReadAllText(@"..\..\Server\" + udfId + ".js"); 
	
   var udfDefinition = new UserDefinedFunction { 
      Id = udfId, 
      Body = udfBody 
   }; 
   
   var result = await client
      .CreateUserDefinedFunctionAsync(_collection.SelfLink, udfDefinition); 
   var udf = result.Resource; 
	
   Console.WriteLine("Created user defined function {0}; RID: {1}", 
      udf.Id, udf.ResourceId);  
		
   return udf; 
}

결과의 리소스 속성에서 새 UDF를 가져와 호출자에게 다시 반환합니다. 기존 UDF를 표시하려면 다음을 구현합니다.ViewUserDefinedFunctions. 우리는 부른다CreateUserDefinedFunctionQuery 평소와 같이 반복합니다.

private static void ViewUserDefinedFunctions(DocumentClient client) { 
   Console.WriteLine(); 
   Console.WriteLine("**** View UDFs ****"); 
   Console.WriteLine(); 
	
   var udfs = client  
      .CreateUserDefinedFunctionQuery(_collection.UserDefinedFunctionsLink) 
      .ToList();  
		
   foreach (var udf in udfs) { 
      Console.WriteLine("User defined function {0}; RID: {1}", udf.Id, udf.ResourceId); 
   }
}

DocumentDB SQL은 하위 문자열 또는 정규 표현식을 검색하는 내장 함수를 제공하지 않으므로 다음과 같은 작은 한 줄짜리가 JavaScript 함수 인 그 간격을 채 웁니다.

function udfRegEx(input, regex) { 
   return input.match(regex); 
}

첫 번째 매개 변수의 입력 문자열이 주어지면 두 번째 매개 변수의 패턴 일치 문자열을에 전달하는 JavaScript의 내장 정규식 지원을 사용합니다.match. 하위 문자열 쿼리를 실행하여 Andersen이라는 단어가 포함 된 모든 상점을 찾을 수 있습니다.lastName 특성.

private static void Execute_udfRegEx(DocumentClient client) { 
   var sql = "SELECT c.name FROM c WHERE udf.udfRegEx(c.lastName, 'Andersen') != null";
	
   Console.WriteLine(); 
   Console.WriteLine("Querying for Andersen"); 
	
   var documents = client.CreateDocumentQuery(_collection.SelfLink, sql).ToList();  
   Console.WriteLine("Found {0} Andersen:", documents.Count); 
	
   foreach (var document in documents) { 
      Console.WriteLine("Id: {0}, Name: {1}", document.id, document.lastName); 
   } 
}

접두사로 모든 ​​UDF 참조를 한정해야합니다. udf. 우리는 SQL을CreateDocumentQuery일반적인 쿼리처럼. 마지막으로 위의 쿼리를CreateDocumentClient 직무

private static async Task CreateDocumentClient() { 
   // Create a new instance of the DocumentClient 
	
   using (var client = new DocumentClient(new Uri(EndpointUrl), AuthorizationKey)){ 
      database = client.CreateDatabaseQuery("SELECT * FROM c WHERE 
         c.id = 'myfirstdb'").AsEnumerable().First();
      collection = client.CreateDocumentCollectionQuery(database.CollectionsLink, 
         "SELECT * FROM c WHERE c.id = 'Families'").AsEnumerable().First();
			 
      await CreateUserDefinedFunctions(client);
   
      ViewUserDefinedFunctions(client);
   
      Execute_udfRegEx(client); 
   } 
}

위의 코드가 실행되면 다음과 같은 출력이 생성됩니다.

**** Create User Defined Functions ****  
Created user defined function udfRegEx; RID: kV5oANVXnwAlAAAAAAAAYA==  
**** View UDFs ****  
User defined function udfRegEx; RID: kV5oANVXnwAlAAAAAAAAYA==  
Querying for Andersen 
Found 1 Andersen: 
 Id: AndersenFamily, Name: Andersen