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

  • 아티클

적용 대상: SQL Server Azure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics AnalyticsPlatform System(PDW)

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

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

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)