SQLGetDiagField
적용 대상: 
SQL Server Azure SQL 데이터베이스 Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System(PDW)
SQL Server Native Client ODBC 드라이버는 SQLGetDiagField에 대해 다음과 같은 추가 진단 필드를 지정합니다. 이러한 필드는 SQL Server 애플리케이션에 대한 풍부한 오류 보고를 지원하며 연결된 ODBC 연결 핸들 및 ODBC 문 핸들에서 생성된 모든 진단 레코드에서 사용할 수 있습니다. 필드는 sqlncli.h에 정의됩니다.
| 진단 레코드 필드 | 설명 |
|---|---|
| SQL_DIAG_SS_LINE | 오류를 생성하는 저장 프로시저의 줄 번호를 보고합니다. SQL_DIAG_SS_LINE 값은 SQL_DIAG_SS_PROCNAME 값을 반환하는 경우에만 의미가 있습니다. 이 값은 부호 없는 16비트 정수로 반환됩니다. |
| SQL_DIAG_SS_MSGSTATE | 오류 메시지의 상태입니다. 오류 메시지 상태에 대한 자세한 내용은 RAISERROR를 참조 하세요. 이 값은 부가적인 32비트 정수로 반환됩니다. |
| SQL_DIAG_SS_PROCNAME | 해당하는 경우 오류를 생성하는 저장 프로시저의 이름입니다. 값은 문자열로 반환됩니다. 문자열의 길이(문자)는 SQL Server 버전에 따라 달라집니다. SQL_MAX_PROCEDURE_NAME_LEN 값을 요청하는 SQLGetInfo를 호출하여 확인할 수 있습니다. |
| SQL_DIAG_SS_SEVERITY | 연결된 오류 메시지의 심각도 수준입니다. 이 값은 부가적인 32비트 정수로 반환됩니다. |
| SQL_DIAG_SS_SRVNAME | 오류가 발생한 서버의 이름입니다. 값은 문자열로 반환됩니다. 문자열의 길이(문자)는 sqlncli.h의 SQL_MAX_SQLSERVERNAME 매크로에 의해 정의됩니다. |
문자 데이터, SQL_DIAG_SS_PROCNAME 및 SQL_DIAG_SS_SRVNAME 포함하는 SQL Server 관련 진단 필드는 null 종료, ANSI 또는 유니코드 문자열로 해당 데이터를 클라이언트에 반환합니다. 필요한 경우 문자 수를 문자 너비에 따라 조정해야 합니다. 또는 TCHAR 또는 SQLTCHAR와 같은 이식 가능한 C 데이터 형식을 사용하여 올바른 프로그램 변수 길이를 보장할 수 있습니다.
SQL Server Native Client ODBC 드라이버는 마지막으로 시도한 SQL Server 문을 식별하는 다음과 같은 추가 동적 함수 코드를 보고합니다. 동적 함수 코드는 진단 레코드 집합의 헤더(레코드 0)에 반환되므로 모든 실행에서 사용할 수 있습니다(성공 여부).
| 동적 함수 코드 | Source |
|---|---|
| SQL_DIAG_DFC_SS_ALTER_DATABASE | ALTER DATABASE 문 |
| SQL_DIAG_DFC_SS_CHECKPOINT | CHECKPOINT 문 |
| SQL_DIAG_DFC_SS_CONDITION | 문의 WHERE 또는 HAVING 절에서 오류 발생 |
| SQL_DIAG_DFC_SS_CREATE_DATABASE | CREATE DATABASE 문 |
| SQL_DIAG_DFC_SS_CREATE_DEFAULT | CREATE DEFAULT 문 |
| SQL_DIAG_DFC_SS_CREATE_PROCEDURE | CREATE PROCEDURE 문 |
| SQL_DIAG_DFC_SS_CREATE_RULE | CREATE RULE 문 |
| SQL_DIAG_DFC_SS_CREATE_TRIGGER | CREATE TRIGGER 문 |
| SQL_DIAG_DFC_SS_CURSOR_DECLARE | DECLARE CURSOR 문 |
| SQL_DIAG_DFC_SS_CURSOR_OPEN | OPEN 문 |
| SQL_DIAG_DFC_SS_CURSOR_FETCH | FETCH 문 |
| SQL_DIAG_DFC_SS_CURSOR_CLOSE | CLOSE 문 |
| SQL_DIAG_DFC_SS_DEALLOCATE_CURSOR | DEALLOCATE 문 |
| SQL_DIAG_DFC_SS_DBCC | DBCC 문 |
| SQL_DIAG_DFC_SS_DENY | DENY 문 |
| SQL_DIAG_DFC_SS_DROP_DATABASE | DROP DATABASE 문 |
| SQL_DIAG_DFC_SS_DROP_DEFAULT | DROP DEFAULT 문 |
| SQL_DIAG_DFC_SS_DROP_PROCEDURE | DROP PROCEDURE 문 |
| SQL_DIAG_DFC_SS_DROP_RULE | DROP RULE 문 |
| SQL_DIAG_DFC_SS_DROP_TRIGGER | DROP TRIGGER 문 |
| SQL_DIAG_DFC_SS_DUMP_DATABASE | BACKUP 또는 DUMP DATABASE 문 |
| SQL_DIAG_DFC_SS_DUMP_TABLE | DUMP TABLE 문 |
| SQL_DIAG_DFC_SS_DUMP_TRANSACTION | BACKUP 또는 DUMP TRANSACTION 문입니다. chkpt의 trunc. log 데이터베이스 옵션이 있는 경우에도 CHECKPOINT 문에 대해 반환됩니다. |
| SQL_DIAG_DFC_SS_GOTO | GOTO 흐름 제어 문 |
| SQL_DIAG_DFC_SS_INSERT_BULK | INSERT BULK 문 |
| SQL_DIAG_DFC_SS_KILL | KILL 문 |
| SQL_DIAG_DFC_SS_LOAD_DATABASE | LOAD 또는 RESTORE DATABASE 문 |
| SQL_DIAG_DFC_SS_LOAD_HEADERONLY | LOAD 또는 RESTORE HEADERONLY 문 |
| SQL_DIAG_DFC_SS_LOAD_TABLE | LOAD TABLE 문 |
| SQL_DIAG_DFC_SS_LOAD_TRANSACTION | LOAD 또는 RESTORE TRANSACTION 문 |
| SQL_DIAG_DFC_SS_PRINT | PRINT 문 |
| SQL_DIAG_DFC_SS_RAISERROR | RAISERROR 문 |
| SQL_DIAG_DFC_SS_READTEXT | READTEXT 문 |
| SQL_DIAG_DFC_SS_RECONFIGURE | RECONFIGURE 문 |
| SQL_DIAG_DFC_SS_RETURN | RETURN 흐름 제어 문 |
| SQL_DIAG_DFC_SS_SELECT_INTO | SELECT INTO 문 |
| SQL_DIAG_DFC_SS_SET | SET 문(제네릭, 모든 옵션) |
| SQL_DIAG_DFC_SS_SET_IDENTITY_INSERT | SET IDENTITY_INSERT 문 |
| SQL_DIAG_DFC_SS_SET_ROW_COUNT | SET ROWCOUNT 문 |
| SQL_DIAG_DFC_SS_SET_STATISTICS | SET STATISTICS IO 또는 SET STATISTICS TIME 문 |
| SQL_DIAG_DFC_SS_SET_TEXTSIZE | CREATE TEXTSIZE 문 |
| SQL_DIAG_DFC_SS_SETUSER | SETUSER 문 |
| SQL_DIAG_DFC_SS_SET_XCTLVL | SET TRANSACTION ISOLATION LEVEL 문 |
| SQL_DIAG_DFC_SS_SHUTDOWN | SHUTDOWN 문 |
| SQL_DIAG_DFC_SS_TRANS_BEGIN | BEGIN TRAN 문 |
| SQL_DIAG_DFC_SS_TRANS_COMMIT | COMMIT TRAN 문 |
| SQL_DIAG_DFC_SS_TRANS_PREPARE | 분산 트랜잭션 커밋 준비 |
| SQL_DIAG_DFC_SS_TRANS_ROLLBACK | ROLLBACK TRAN 문 |
| SQL_DIAG_DFC_SS_TRANS_SAVE | SAVE TRAN 문 |
| SQL_DIAG_DFC_SS_TRUNCATE_TABLE | TRUNCATE TABLE 문 |
| SQL_DIAG_DFC_SS_UPDATE_STATISTICS | UPDATE STATISTICS 문 |
| SQL_DIAG_DFC_SS_UPDATETEXT | UPDATETEXT 문 |
| SQL_DIAG_DFC_SS_USE | USE 문 |
| SQL_DIAG_DFC_SS_WAITFOR | WAITFOR 흐름 제어 문 |
| SQL_DIAG_DFC_SS_WRITETEXT | WRITETEXT 문 |
SQLGetDiagField 및 테이블 반환 매개 변수
SQLGetDiagField를 사용하여 SQL_DIAG_SS_TABLE_COLUMN_NUMBER 및 SQL_DIAG_SS_TABLE_ROW_NUMBER 두 개의 진단 필드를 검색할 수 있습니다. 이러한 필드는 진단 레코드와 관련된 오류 또는 경고를 발생시킨 값을 확인하는 데 도움이 됩니다.
테이블 반환 매개 변수에 대한 자세한 내용은 ODBC(테이블 반환 매개 변수)를 참조하세요.