문 사용(ODBC)
적용 대상:
SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System(PDW)
문을 사용하려면
SQL_HANDLE_STMT HandleType을 사용하여 SQLAllocHandle을 호출하여 문 핸들을 할당합니다.
필요에 따라 SQLSetStmtAttr를 호출하여 문 옵션을 설정하거나 SQLGetStmtAttr을 호출하여 문 특성을 가져옵니다.
서버 커서를 사용하려면 커서 특성을 기본값이 아닌 값으로 설정해야 합니다.
필요에 따라 문이 여러 번 실행되는 경우 SQLPrepare 함수를 사용하여 실행할 문을 준비합니다.
필요에 따라 문에 바인딩된 매개 변수 표식이 있는 경우 SQLBindParameter를 사용하여 매개 변수 마커를 프로그램 변수에 바인딩합니다. 문이 준비되어 있으면 SQLNumParams 및 SQLDescribeParam을 호출하여 매개 변수의 수와 특징을 확인할 수 있습니다.
SQLExecDirect를 사용하여 문을 직접 실행합니다.
- 또는 -
문이 준비되어 있는 경우 SQLExecute를 사용하여 여러 번 실행합니다.
- 또는 -
카탈로그 함수를 호출하여 결과가 반환되도록 합니다.
결과 집합 열을 프로그램 변수에 바인딩하거나, SQLGetData 또는 두 메서드의 조합을 사용하여 결과 집합 열에서 프로그램 변수로 데이터를 이동하여 결과를 처리합니다.
문의 결과 집합을 한 번에 한 행씩 인출합니다.
- 또는 -
블록 커서를 사용하여 결과 집합을 한 번에 여러 행으로 가져옵니다.
- 또는 -
SQLRowCount를 호출하여 INSERT, UPDATE 또는 DELETE 문의 영향을 받는 행 수를 확인합니다.
SQL 문에 여러 결과 집합이 있을 수 있는 경우 각 결과 집합의 끝에 SQLMoreResults를 호출하여 처리할 추가 결과 집합이 있는지 확인합니다.
결과 집합이 처리된 후에는 새 문을 실행하는 데 문 핸들을 사용할 수 있도록 하기 위해 다음 동작을 수행해야 할 수도 있습니다.
SQL_NO_DATA 반환될 때까지 SQLMoreResults를 호출하지 않은 경우 SQLCloseCursor를 호출하여 커서를 닫습니다.
매개 변수 표식을 프로그램 변수에 바인딩한 경우 옵션 집합이 있는 SQLFreeStmt를 호출하여 SQL_RESET_PARAMS 바인딩된 매개 변수를 해제합니다.
결과 집합 열을 프로그램 변수에 바인딩한 경우 옵션 집합이 있는 SQLFreeStmt를 호출하여 SQL_UNBIND 바인딩된 열을 해제합니다.
문 핸들을 다시 사용하려면 2단계로 이동합니다.
SQL_HANDLE_STMT HandleType을 사용하여 SQLFreeHandle을 호출하여 문 핸들을 해제합니다.