다음을 통해 공유


SQLGetStmtAttr

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

SQL Server Native Client ODBC 드라이버는 SQLGetStmtAttr를 확장하여 드라이버별 문 특성을 노출합니다.

SQLSetStmtAttr 에서는 읽기 및 쓰기 문 특성을 나열합니다. 이 항목에서는 읽기 전용 문 특성을 나열합니다.

SQL_SOPT_SS_CURRENT_COMMAND

SQL_SOPT_SS_CURRENT_COMMAND 특성은 명령 일괄 처리의 현재 명령을 노출합니다. 반환은 일괄 처리에서 명령의 위치를 지정하는 정수입니다. ValuePtr 값은 SQLLEN 형식입니다.

SQL_SOPT_SS_NOCOUNT_STATUS

SQL_SOPT_SS_NOCOUNT_STATUS 특성은 SQLRowCount를 호출할 때 SQL Server가 문의 영향을 받는 행 수를 보고하는지 여부를 제어하는 NOCOUNT 옵션의 현재 설정을 나타냅니다. ValuePtr 값은 SQLLEN 형식입니다.

설명
SQL_NC_OFF NOCOUNT가 OFF입니다. SQLRowCount는 영향을 받는 행 수를 반환합니다.
SQL_NC_ON NOCOUNT가 ON입니다. 영향을 받는 행 수는 SQLRowCount에서 반환되지 않으며 반환된 값은 0입니다.

SQLRowCount가 0을 반환하는 경우 애플리케이션은 SQL_SOPT_SS_NOCOUNT_STATUS 테스트해야 합니다. SQL_NC_ON 반환되는 경우 SQLRowCount의 값 0은 SQL Server가 행 수를 반환하지 않았다는 것만 나타냅니다. SQL_NC_OFF 반환되면 NOCOUNT가 꺼져 있고 SQLRowCount의 값이 0이면 문이 행에 영향을 주지 않았음을 나타냅니다.

SQL_SOPT_SS_NOCOUNT_STATUS SQL_NC_OFF 경우 애플리케이션에서 SQLRowCount 값을 표시해서는 안 됩니다. 대규모 일괄 처리나 저장 프로시저에서는 여러 개의 SET NOCOUNT 문을 포함할 수 있으므로 SQL_SOPT_SS_NOCOUNT_STATUS가 일정하게 유지되지 않을 수 있습니다. SQLRowCount가 0을 반환할 때마다 이 옵션을 테스트해야 합니다.

SQL_SOPT_SS_QUERYNOTIFICATION_MSGTEXT

SQL_SOPT_SS_QUERYNOTIFICATION_MSGTEXT 특성은 쿼리 알림 요청에 대한 메시지 텍스트를 반환합니다.

SQLGetStmtAttr 및 테이블 반환 매개 변수

테이블 반환 매개 변수로 작업할 때 APD(애플리케이션 매개 변수 설명자)에서 SQL_SOPT_SS_PARAM_FOCUS 값을 가져오기 위해 SQLGetStmtAttr을 호출할 수 있습니다. SQL_SOPT_SS_PARAM_FOCUS 대한 자세한 내용은 SQLSetStmtAttr을 참조하세요.

테이블 반환 매개 변수에 대한 자세한 내용은 ODBC(테이블 반환 매개 변수)를 참조하세요.

참고 항목

SQLSetStmtAttr 함수
ODBC API 구현 정보