테이블 반환 매개 변수(ODBC)

적용 대상: SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System(PDW)

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

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

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

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

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

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

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

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

섹션 내용

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

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

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

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

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

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

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

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

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

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

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

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

참고 항목

SQL Server Native Client(ODBC)
테이블 반환 매개 변수(SQL Server Native Client)