테이블 반환 매개 변수 설명자 필드
적용 대상:
SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System(PDW)
테이블 반환 매개 변수에 대한 지원에는 ODBC APD(애플리케이션 매개 변수 설명자) 및 IPD(구현 매개 변수 설명자)의 새 SQL Server 관련 필드가 포함됩니다.
설명
| 속성 | 위치 | Type | 설명 |
|---|---|---|---|
| SQL_CA_SS_TYPE_NAME | IPD | SQLTCHAR* | 테이블 반환 매개 변수의 서버 유형 이름입니다. SQLBindParameter 호출 시 테이블 반환 매개 변수 형식 이름을 지정하는 경우 ANSI 애플리케이션으로 빌드된 애플리케이션에서도 항상 유니코드 값으로 지정해야 합니다. 매개 변수 StrLen_or_IndPtr 사용되는 값은 SQL_NTS 또는 이름의 문자열 길이에 sizeof(WCHAR)를 곱해야 합니다. SQLSetDescField를 통해 테이블 반환 매개 변수 형식 이름을 지정하는 경우 애플리케이션이 빌드되는 방식에 맞는 리터럴을 사용하여 지정할 수 있습니다. ODBC 드라이버 관리자는 필요한 유니코드 변환을 수행합니다. |
| SQL_CA_SS_TYPE_CATALOG_NAME(읽기 전용) | IPD | SQLTCHAR* | 유형이 정의된 카탈로그입니다. |
| SQL_CA_SS_TYPE_SCHEMA_NAME | IPD | SQLTCHAR* | 형식이 정의된 스키마입니다. |
애플리케이션은 테이블 반환 매개 변수에 대한 SQL_CA_SS_TYPE_CATALOG_NAME 설정해서는 안 됩니다. 이렇게 하면 SQL_ERROR가 반환되며 SQLSTATE = HY091 및 "잘못된 설명자 필드 식별자입니다"라는 메시지가 포함된 진단 레코드가 기록됩니다.
매개 변수 포커스가 테이블 반환 매개 변수로 설정된 경우 다음 문 특성 및 설명자 헤더 필드가 테이블 반환 매개 변수에 적용됩니다.
| 속성 | 위치 | Type | 설명 |
|---|---|---|---|
| SQL_ATTR_PARAMSET_SIZE APD의 SQL_DESC_ARRAY_SIZE 것과 같습니다. |
APD | SQLUINTEGER | 테이블 반환 매개 변수에 대한 버퍼 배열의 배열 크기입니다. 이 값은 버퍼에 포함될 최대 행 수이거나 행의 버퍼 크기입니다. 테이블 반환 매개 변수 값 자체는 버퍼에 포함될 수 있는 것보다 많거나 적은 행을 포함할 수 있습니다. 기본값은 1입니다. 참고: SQL_SOPT_SS_PARAM_FOCUS 기본값 0으로 설정된 경우 SQL_ATTR_PARAMSET_SIZE 문을 참조하고 매개 변수 집합 수를 지정합니다. SQL_SOPT_SS_PARAM_FOCUS가 테이블 반환 매개 변수의 서수로 설정된 경우 테이블 반환 매개 변수를 참조하며 테이블 반환 매개 변수에 대해 매개 변수 집합당 행 수를 지정합니다. |
| SQL_ATTR_PARAM _BIND_TYPE | APD | SQLINTEGER | 기본값은 SQL_PARAM_BIND_BY_COLUMN. 행 단위 바인딩을 선택하려면 이 필드를 테이블 반환 매개 변수 행 집합에 바인딩될 버퍼 인스턴스나 구조의 길이로 설정합니다. 이 길이에는 모든 바인딩된 열의 공간과 구조체 또는 버퍼의 패딩이 포함되어야 합니다. 이렇게 하면 지정된 길이로 바인딩된 열의 주소가 증가하면 결과가 다음 행에 있는 동일한 열의 시작을 가리킵니다. ANSI C에서 sizeof 연산자를 사용하는 경우 이 동작이 보장됩니다. |
| SQL_ATTR_PARAM_BIND_OFFSET_PTR | APD | SQLINTEGER* | 기본값은 Null 포인터입니다. 이 필드가 null이 아닌 경우 드라이버는 포인터를 역참조하고 설명자 레코드(SQL_DESC_DATA_PTR, SQL_DESC_INDICATOR_PTR 및 SQL_DESC_OCTET_LENGTH_PTR)의 지연된 각 필드에 역참조된 값을 추가하고 새 포인터 값을 사용하여 데이터 값에 액세스합니다. |
이러한 필드는 테이블 반환 매개 변수에서만 유효하며 다른 데이터 형식에 대해서는 무시됩니다.
저장 프로시저 호출에서 SQL_CA_SS_TYPE_NAME은 옵션입니다. 서버가 테이블 반환 매개 변수의 형식을 결정할 수 있도록 프로시저 호출이 아닌 SQL 문에 대해 지정해야 합니다.
유형 이름이 필수이고 테이블 반환 매개 변수의 테이블 유형이 저장 프로시저와는 다른 스키마에 정의되어 있으면 IPD(구현 매개 변수 설명자)에 SQL_CA_SS_TYPE_SCHEMA_NAME을 지정해야 합니다. 그렇지 않은 경우 서버는 테이블 반환 매개 변수의 형식을 확인할 수 없습니다. 이렇게 하면 SQLExecute 또는 SQLExecDirect를 호출할 때 오류가 발생합니다. 오류에는 SQLSTATE= 07006 및 "제한된 데이터 형식 특성을 위반했습니다"라는 메시지가 포함됩니다.
테이블 반환 매개 변수 열은 행 단위 또는 열 단위 바인딩을 사용할 수 있습니다. 기본값은 열 단위 바인딩입니다. 행 단위 바인딩은 SQL_ATTR_PARAM_BIND_TYPE 및 SQL_ATTR_ PARAM_BIND_OFFSET_PTR 설정하여 지정할 수 있습니다. 이는 열 및 매개 변수의 행 단위 바인딩과 유사합니다.
SQL_CA_SS_TYPE_CATALOG_NAME 및 SQL_CA_SS_TYPE_SCHEMA_NAME 사용하여 CLR 사용자 정의 형식 매개 변수와 연결된 카탈로그 및 스키마를 검색할 수도 있습니다. 이러한 형식에 대한 기존 형식 특정 카탈로그 스키마 특성의 대안입니다.