행 집합 바인딩 사용(ODBC)

  • 아티클

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

열 단위 바인딩을 사용하려면

  1. 바인딩된 각 열에 대해 다음을 수행합니다.

    • 데이터 값을 저장할 R개 이상의 열 버퍼 배열을 할당합니다. 여기서 R은 행 집합의 행 수입니다.

    • 필요에 따라 데이터 길이를 저장할 R개 이상의 열 버퍼 배열을 할당합니다.

    • SQLBindCol 을 호출하여 열의 데이터 값 및 데이터 길이 배열을 행 집합의 열에 바인딩합니다.

  2. SQLSetStmtAttr 을 호출하여 다음 특성을 설정합니다.

    • SQL_ATTR_ROW_ARRAY_SIZE를 행 집합의 행 수(R)로 설정합니다.

    • SQL_ATTR_ROW_BIND_TYPE을 SQL_BIND_BY_COLUMN으로 설정합니다.

    • SQL_ATTR_ROWS FETCHED_PTR 특성을 인출된 행 수를 보유하는 SQLUINTEGER 변수를 가리키도록 설정합니다.

    • SQL_ATTR_ROW_STATUS_PTR을 행 상태 표시를 보유하는 SQLUSSMALLINT 변수의 배열[R]을 가리키도록 설정합니다.

  3. 해당 문을 실행합니다.

  4. SQLFetch 또는 SQLFetchScroll 에 대한 각 호출에서 R개의 행을 검색하여 데이터를 바인딩된 열로 전송합니다.

행 단위 바인딩을 사용하려면

  1. 구조의 배열[R]을 할당합니다. 여기서 R은 행 집합의 행 수입니다. 구조에는 각 열에 대해 요소가 하나씩 포함되고 각 요소에는 두 부분이 포함됩니다.

    • 첫 번째 부분은 열 데이터를 보유하는 적절한 데이터 형식의 변수입니다.

    • 두 번째 부분은 열 상태 표시를 보유하는 SQLINTEGER 변수입니다.

  2. SQLSetStmtAttr 을 호출하여 다음 특성을 설정합니다.

    • SQL_ATTR_ROW_ARRAY_SIZE를 행 집합의 행 수(R)로 설정합니다.

    • SQL_ATTR_ROW_BIND_TYPE을 1단계에서 할당한 구조의 크기로 설정합니다.

    • SQL_ATTR_ROWS_FETCHED_PTR 특성을 인출된 행 수를 보유하는 SQLUINTEGER 변수를 가리키도록 설정합니다.

    • SQL_ATTR_PARAMS_STATUS_PTR을 행 상태 표시를 보유하는 SQLUSSMALLINT 변수의 배열[R]을 가리키도록 설정합니다.

  3. 결과 집합의 각 열에 대해 SQLBindCol 을 호출하여 열의 데이터 값 및 데이터 길이 포인터가 1단계에서 할당한 구조 배열의 첫 번째 요소에 있는 해당 변수를 가리키도록 합니다.

  4. 해당 문을 실행합니다.

  5. SQLFetch 또는 SQLFetchScroll 에 대한 각 호출에서 R개의 행을 검색하여 데이터를 바인딩된 열로 전송합니다.

참고 항목

커서 사용 방법 도움말 항목(ODBC)
커서 구현 방법
커서 사용(ODBC)