WCF 서비스 모델을 사용하여 SQL Server Table-Valued 함수 호출

아티클
10/14/2023

WCF 서비스 모델을 사용하여 .NET 애플리케이션에서 SQL 어댑터를 사용하여 SQL Server 테이블 반환 함수를 호출할 수 있습니다. 어댑터는 테이블 반환 함수를 SQL Server 직접 호출할 수 있는 메서드로 노출합니다. 어댑터가 스칼라 함수를 지원하는 방법에 대한 자세한 내용은 SQL 어댑터를 사용하여 SQL Server Table-Valued 함수 실행을 참조하세요.

이 항목에서는 SQL Server 데이터베이스에서 TVF_EMPLOYEE 함수를 호출하는 방법을 보여 줍니다. TVF_EMPLOYEE 함수는 Employee 테이블에서 직원을 지정하고 직원의 레코드를 반환합니다. TVF_EMPLOYEE 함수 및 Employee 테이블은 샘플과 함께 제공되는 SQL 스크립트를 실행하여 만듭니다. 자세한 내용은 어댑터 샘플을 참조하세요.

이 항목에 사용된 예제 정보

이 항목의 예제에서는 Employee 테이블에서 TVF_EMPLOYEE 테이블 반환 함수를 호출했습니다. TVF_EMPLOYEE 함수 및 Employee 테이블은 샘플과 함께 제공되는 SQL 스크립트를 실행하여 생성됩니다. 이 항목을 기반으로 하는 샘플 TableFunction_ServiceModel SQL 어댑터 샘플도 제공됩니다. 자세한 내용은 어댑터 샘플을 참조하세요.

WCF 클라이언트 클래스

SQL 어댑터를 사용하여 SQL Server 스칼라 함수를 호출하기 위해 생성된 WCF 클라이언트의 이름은 다음 표에 나와 있습니다.

데이터베이스 아티팩트 SQL Server	WCF 클라이언트 이름
테이블 반환 함수	TableValuedFunctions_[SCHEMA]클라이언트

[SCHEMA] = SQL Server 아티팩트 컬렉션(예: dbo).

테이블 반환 함수를 호출하기 위한 메서드 서명

다음 표에서는 테이블의 기본 작업에 대한 메서드 서명을 보여 줍니다. 뷰 네임스페이스와 이름이 테이블의 네임스페이스를 대체한다는 점을 제외하고 보기의 서명은 동일합니다.

작업	메서드 시그니처
테이블 반환 함수 이름	public [NAMESPACE][FUNCTION_NAME][] [FUNCTION_NAME](param1, param2, ...)

[NAMESPACE] = 네임스페이스(예: schemas.microsoft.com.Sql._2008._05.Types.TableFunctionReturnTables.dbo.TVF_EMPLOYEE)

[FUNCTION_NAME] = 테이블 반환 함수의 이름입니다.

예를 들어 다음 코드는 dbo 스키마에서 TVF_EMPLOYEE 스칼라 함수에 대해 생성된 WCF 클라이언트 클래스에 대한 메서드 서명을 보여 줍니다. 이 메서드는 직원 지정을 매개 변수로 사용하고 직원 레코드를 반환합니다.

public partial class TableValuedFunctions_dboClient : System.ServiceModel.ClientBase<TableValuedFunctions_dbo>, TableValuedFunctions_dbo {      
    public schemas.microsoft.com.Sql._2008._05.Types.TableFunctionReturnTables.dbo.TVF_EMPLOYEE[] TVF_EMPLOYEE(string emp_desig);  
}

이 코드 조각에서 TableValuedFunctions_dboClient 어댑터 서비스 참조 플러그 인 추가에서 생성된 SqlAdapterBindingClient.cs의 WCF 클래스 이름입니다.

테이블 반환 함수를 호출하기 위한 매개 변수

SQL 어댑터에서 테이블 반환 함수를 호출하기 위해 노출하는 메서드에 대한 매개 변수는 SQL Server 함수 정의에 정의된 매개 변수와 동일합니다. 예를 들어 TVF_EMPLOYEE 테이블 반환 함수를 호출하기 위한 매개 변수는 emp_desig 직원의 지정을 사용합니다.

다시 말하지만 테이블 반환 함수의 반환 값은 SQL Server 함수 정의에 정의된 반환 값과 동일합니다. 예를 들어 TVF_EMPLOYEE 함수의 반환 값은 schemas.microsoft.com.Sql._2008._05.Types.TableFunctionReturnTables.dbo.TVF_EMPLOYEE[] 형식의 레코드 배열입니다.

테이블 반환 함수를 호출하는 WCF 클라이언트 만들기

WCF 클라이언트를 사용하여 SQL Server 작업을 수행하는 데 필요한 제네릭 작업 집합에는 SQL 어댑터를 사용한 WCF 서비스 모델 개요에 설명된 작업 집합이 포함됩니다. 이 섹션에서는 TVF_EMPLOYEE 테이블 반환 함수를 호출하는 WCF 클라이언트를 만드는 방법을 설명합니다.

Visual Studio에서 Visual C# 프로젝트를 만듭니다. 이 항목의 경우 콘솔 애플리케이션을 만듭니다.
TVF_EMPLOYEE 스칼라 함수에 대한 WCF 클라이언트 클래스를 생성합니다. WCF 클라이언트 클래스를 생성하는 방법에 대한 자세한 내용은 SQL Server 아티팩트용 WCF 클라이언트 또는 WCF 서비스 계약 생성을 참조하세요.
솔루션 탐색기 및 Microsoft.ServiceModel.Channels에 대한 참조를 추가합니다Microsoft.Adapters.Sql.
아래 코드 조각에 설명된 대로 Program.cs를 열고 클라이언트를 만듭니다.
```
          TableValuedFunctions_dboClient client = new TableValuedFunctions_dboClient("SqlAdapterBinding_TableValuedFunctions_dbo");  
client.ClientCredentials.UserName.UserName = "<Enter user name here>";  
client.ClientCredentials.UserName.Password = "<Enter password here>";  
```
이 코드 조각 TableValuedFunctions_dboClient 에서 은 SqlAdapterBindingClient.cs에 정의된 WCF 클라이언트입니다. 이 파일은 어댑터 서비스 참조 추가 플러그 인에 의해 생성됩니다. SqlAdapterBinding_TableValuedFunctions_dbo 는 클라이언트 엔드포인트 구성의 이름이며 app.config 정의됩니다. 이 파일은 어댑터 서비스 참조 추가 플러그 인에서도 생성되며 바인딩 속성 및 기타 구성 설정을 포함합니다.

참고

이 코드 조각에서는 구성 파일의 바인딩 및 엔드포인트 주소를 사용합니다. 코드에서 이러한 값을 명시적으로 지정할 수도 있습니다. 클라이언트 바인딩을 지정하는 다양한 방법에 대한 자세한 내용은 SQL 어댑터에 대한 클라이언트 바인딩 구성을 참조하세요.

아래 코드 조각에 설명된 대로 클라이언트를 엽니다.

try  
{  
   Console.WriteLine("Opening Client...");  
   client.Open();  
}  
catch (Exception ex)  
{  
   Console.WriteLine("Exception: " + ex.Message);  
   throw;  
}

TVF_EMPLOYEE 함수를 호출하여 "Manager" 지정이 있는 모든 직원 레코드를 검색합니다.

Console.WriteLine("Invoking the TVF_EMPLOYEE function");  
schemas.microsoft.com.Sql._2008._05.Types.TableFunctionReturnTables.dbo.TVF_EMPLOYEE[] emp_details;  
string emp_designation = "Manager";  

try  
{  
    emp_details = client.TVF_EMPLOYEE(emp_designation);  
}  
catch (Exception e)  
{  
    Console.WriteLine("Exception: " + e.Message);  
    throw;  
}  
Console.WriteLine("The details for the employee with the 'Manager' designation are:");  
Console.WriteLine("*******************************************************************");  
for (int i = 0; i < emp_details.Length; i++)  
{  
    Console.WriteLine("Employee ID        : " + emp_details[i].Employee_ID);  
    Console.WriteLine("Employee Name      : " + emp_details[i].Name);  
    Console.WriteLine("Employee Desigation: " + emp_details[i].Designation);  
    Console.WriteLine("Employee Salary    : " + emp_details[i].Salary);  
    Console.WriteLine();  
}

아래 코드 조각에 설명된 대로 클라이언트를 닫습니다.

client.Close();  
Console.WriteLine("Press any key to exit...");  
Console.ReadLine();

프로젝트를 빌드한 다음 실행합니다. 애플리케이션은 "관리자" 지정을 사용하여 모든 직원의 직원 ID, 이름 및 급여를 표시합니다.

참고 항목

WCF 서비스 모델을 사용하여 애플리케이션 개발

다음을 통해 공유