행 집합 바인딩 사용(ODBC)

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

바인딩된 각 열에 대해 다음을 수행합니다.
- R(또는 그 이상) 열 버퍼 배열을 할당하여 데이터 값을 저장합니다. 여기서 R은 행 집합의 행 수입니다.
- 필요에 따라 R(또는 그 이상) 열 버퍼 배열을 할당하여 데이터 길이를 저장합니다.
- SQLBindCol을 호출하여 열의 데이터 값 및 데이터 길이 배열을 행 집합의 열에 바인딩합니다.
SQLSetStmtAttr을 호출하여 다음 특성을 설정합니다.
- SQL_ATTR_ROW_ARRAY_SIZE 행 집합(R)의 행 수로 설정합니다.
- SQL_ATTR_ROW_BIND_TYPE SQL_BIND_BY_COLUMN 설정합니다.
- SQL_ATTR_ROWS FETCHED_PTR 특성을 SQLUINTEGER 변수를 가리키도록 설정하여 가져온 행 수를 저장합니다.
- 행 상태 표시기를 저장할 SQLUSSMALLINT 변수의 배열[R]을 가리키도록 SQL_ATTR_ROW_STATUS_PTR 설정합니다.
해당 문을 실행합니다.
SQLFetch 또는 SQLFetchScroll 에 대한 각 호출에서 R개의 행을 검색하여 데이터를 바인딩된 열로 전송합니다.

구조체의 배열[R]을 할당합니다. 여기서 R은 행 집합의 행 수입니다. 구조체에는 각 열에 대해 하나의 요소가 있으며 각 요소에는 다음 두 부분이 있습니다.
- 첫 번째 부분은 열 데이터를 저장할 적절한 데이터 형식의 변수입니다.
- 두 번째 부분은 열 상태 표시기를 저장할 SQLINTEGER 변수입니다.
SQLSetStmtAttr을 호출하여 다음 특성을 설정합니다.
- SQL_ATTR_ROW_ARRAY_SIZE 행 집합(R)의 행 수로 설정합니다.
- SQL_ATTR_ROW_BIND_TYPE 1단계에서 할당된 구조체의 크기로 설정합니다.
- SQL_ATTR_ROWS_FETCHED_PTR 특성을 SQLUINTEGER 변수를 가리키도록 설정하여 가져온 행 수를 저장합니다.
- 행 상태 표시기를 저장할 SQLUSSMALLINT 변수의 배열[R]을 가리키도록 SQL_ATTR_PARAMS_STATUS_PTR 설정합니다.
결과 집합의 각 열에 대해 SQLBindCol 을 호출하여 열의 데이터 값 및 데이터 길이 포인터가 1단계에서 할당한 구조 배열의 첫 번째 요소에 있는 해당 변수를 가리키도록 합니다.
해당 문을 실행합니다.
SQLFetch 또는 SQLFetchScroll 에 대한 각 호출에서 R개의 행을 검색하여 데이터를 바인딩된 열로 전송합니다.

참고 항목