다음을 통해 공유


Table-Valued 매개 변수(ODBC)

테이블 반환 매개 변수에 대한 ODBC 지원을 통해 클라이언트 애플리케이션은 한 번의 호출로 여러 행을 서버에 전송하여 매개 변수가 있는 데이터를 서버에 보다 효율적으로 보낼 수 있습니다.

서버의 테이블 반환 매개 변수에 대한 자세한 내용은 Table-Valued 매개 변수 사용(데이터베이스 엔진)을 참조하세요.

ODBC에서는 두 가지 방법으로 테이블 반환 매개 변수를 서버에 보낼 수 있습니다.

  • 모든 테이블 반환 매개 변수 데이터는 SQLExecDirect 또는 SQLExecute가 호출될 때 메모리에 있을 수 있습니다. 이 데이터는 테이블 값에 여러 행이 있는 경우 배열에 저장됩니다.

  • 애플리케이션은 SQLExecDirect 또는 SQLExecute가 호출될 때 테이블 반환 매개 변수에 대한 실행 시 데이터를 지정할 수 있습니다. 이 경우 테이블 값에 대한 데이터 행을 일괄 처리로 제공하거나 메모리 요구 사항을 줄이기 위해 한 번에 하나씩 제공할 수 있습니다.

첫 번째 옵션을 사용하면 저장 프로시저가 더 많은 비즈니스 논리를 캡슐화할 수 있습니다. 예를 들어 단일 저장 프로시저는 주문 항목이 테이블 반환 매개 변수로 전달될 때 전체 주문 항목 트랜잭션을 캡슐화할 수 있습니다. 이 옵션은 서버로의 왕복이 한 번만 필요하기 때문에 매우 효율적입니다. 또는 다른 절차를 사용하여 주문 헤더와 주문 항목을 개별적으로 처리할 수 있습니다. 이 경우 클라이언트와 서버 간에 더 많은 코드와 더 복잡한 계약이 필요합니다.

두 번째 방법은 매우 많은 양의 데이터를 사용하여 대량 작업을 위한 효율적인 메커니즘을 제공합니다. 이렇게 하면 애플리케이션이 먼저 메모리에서 모두 버퍼링하지 않고도 데이터 행을 서버로 스트리밍할 수 있습니다.

테이블 변수를 만들 때 제약 조건 및 기본 키를 만들 수 있습니다. 제약 조건은 테이블의 데이터가 특정 요구 사항을 충족하도록 하는 좋은 방법입니다.

이 섹션 안에

ODBC Table-Valued 매개 변수 사용
테이블 반환 매개 변수 및 ODBC에 대한 기본 사용자 시나리오에 대해 설명합니다.

Table-Valued 매개 변수에 대한 ODBC SQL 형식
SQL_SS_TABLE 형식에 대해 설명합니다. 테이블 반환 매개 변수를 지원하는 새로운 ODBC SQL 형식입니다.

Table-Valued 매개 변수 설명자 필드
테이블 반환 매개 변수를 지원하는 설명자 필드에 대해 설명합니다.

Table-Valued 매개 변수 구성 요소 열에 대한 설명자 필드
테이블 반환 매개 변수에 의미가 있는 설명자 필드에 대해 설명합니다.

Table-Valued 매개 변수 진단 레코드 필드
테이블 반환 매개 변수를 지원하기 위해 진단 레코드에 추가된 두 개의 진단 필드에 대해 설명합니다.

Table-Valued 매개 변수에 영향을 주는 문 특성
테이블 반환 매개 변수 열의 주소를 지정하는 데 사용할 수 있는 새 설명자 헤더 필드에 대해 설명합니다.

Table-Valued 매개 변수 및 열 값의 바인딩 및 데이터 전송
매개 변수 바인딩 및 테이블 반환 매개 변수를 서버에 전달하는 방법을 설명합니다.

준비된 문에 대한 매개 변수 메타데이터Table-Valued
애플리케이션이 준비된 프로시저 호출에 대한 메타데이터를 가져오는 방법을 설명합니다.

추가 Table-Valued 매개 변수 메타데이터
SQLProcedureColumns, SQLTables 및 SQLColumns를 사용하여 테이블 반환 매개 변수에 대한 메타데이터를 검색하는 방법을 설명합니다.

Table-Valued 매개 변수 데이터 변환 및 기타 오류 및 경고
테이블 반환 매개 변수 열 값에 대한 오류를 처리하는 방법을 설명합니다.

버전 간 호환성
SQL Server 2008 이전 버전의 클라이언트 또는 서버에서 테이블 반환 매개 변수를 사용할 때 발생할 수 있는 충돌을 설명합니다.

ODBC Table-Valued 매개 변수 API 요약
테이블 반환 매개 변수를 지원하는 ODBC 함수를 나열합니다.

ODBC Table-Valued 매개 변수 프로그래밍 예제
일반적인 작업을 수행하는 방법을 설명합니다.

또한 참조하십시오

SQL Server Native Client(ODBC)
Table-Valued 매개 변수(SQL Server Native Client)