SQL_NUMERIC_STRUCT 사용하여 숫자 데이터 검색

아티클
08/21/2023

이 문서에서는 SQL Server ODBC 드라이버에서 숫자 구조로 숫자 데이터를 검색하는 방법을 설명합니다. 또한 특정 정밀도 및 배율 값을 사용하여 올바른 값을 가져오는 방법에 대해서도 설명합니다.

이 데이터 형식을 사용하면 애플리케이션에서 숫자 데이터를 직접 처리할 수 있습니다. 2003년 경, ODBC 3.0은 SQL_C_NUMERIC 식별되는 새로운 ODBC C 데이터 형식을 도입했습니다. 이 데이터 형식은 2017년 현재에도 여전히 관련이 있습니다.

사용되는 C 버퍼에는 SQL_NUMERIC_STRUCT 형식 정의가 있습니다. 이 구조에는 숫자 데이터의 전체 자릿수, 소수 자릿수, 기호 및 값을 저장하기 위한 필드가 있습니다. 값 자체는 가장 왼쪽 위치에서 시작하는 가장 작은 바이트를 사용하여 크기가 조정된 정수로 저장됩니다.

C 데이터 형식 문서에서는 SQL_NUMERIC_STRUCT 형식 및 사용에 대한 자세한 정보를 제공합니다. 일반적으로 ODBC 3.0 프로그래머 참조의 부록 D 는 데이터 형식에 대해 설명합니다.

SQL_NUMERIC_STRUCT 개요

SQL_NUMERIC_STRUCT 다음과 같이 sqltypes.h 헤더 파일에 정의됩니다.

#define SQL_MAX_NUMERIC_LEN    16
typedef struct tagSQL_NUMERIC_STRUCT
{
   SQLCHAR    precision;
   SQLSCHAR   scale;
   SQLCHAR    sign;   /* 1 if positive, 0 if negative */
   SQLCHAR    val[SQL_MAX_NUMERIC_LEN];
} SQL_NUMERIC_STRUCT;

숫자 구조의 전체 자릿수 및 배율 필드는 애플리케이션의 입력에 사용되지 않으며 드라이버에서 애플리케이션으로의 출력에만 사용됩니다.

드라이버는 애플리케이션에 데이터를 반환할 때마다 기본 전체 자릿수(드라이버 정의) 및 기본 소수 자릿수(0)를 사용합니다. 애플리케이션에서 정밀도 및 배율 값을 지정하지 않는 한 드라이버는 기본값을 가정하고 숫자 데이터의 소수 부분을 자립니다.

SQL_NUMERIC_STRUCT 코드 샘플

이 코드 샘플에서는 다음 방법을 보여줍니다.

전체 자릿수를 설정합니다.
배율을 설정합니다.
올바른 값을 검색합니다.

참고 항목

이 문서에 제공된 코드의 모든 사용은 사용자 고유의 위험에 노출됩니다.

Microsoft는 특정 목적에 대한 상품성 및/또는 적합성에 대한 묵시적 보증을 포함하지만 이에 국한되지 않는 어떠한 종류의 보증도 없이 이러한 코드 샘플을 "있는 그대로" 제공합니다.

#include <stdio.h>
#include <string.h>
#include <conio.h>
#include <stdlib.h>
#include <ctype.h>
#include <windows.h>
#include <sql.h>
#include <sqlext.h>

#define MAXDSN       25
#define MAXUID       25
#define MAXAUTHSTR   25
#define MAXBUFLEN   255

SQLHENV     henv   = SQL_NULL_HENV;
SQLHDBC     hdbc1  = SQL_NULL_HDBC;     
SQLHSTMT    hstmt1 = SQL_NULL_HSTMT;
SQLHDESC    hdesc  = NULL;


SQL_NUMERIC_STRUCT NumStr;

int main()
{
   RETCODE retcode;

//Change the values below as appropriate to make a successful connection.
//szDSN: DataSourceName, szUID=userid, szAuthStr: password

UCHAR szDSN[MAXDSN+1] = "sql33",szUID[MAXUID+1]="sa", szAuthStr[MAXAUTHSTR+1] = "";
SQLINTEGER strlen1;
SQLINTEGER a;
int i,sign =1;
long myvalue, divisor;
float final_val;
   
// Allocate the Environment handle. Set the Env attribute, allocate the
//connection handle, connect to the database and allocate the statement //handle.

retcode = SQLAllocHandle (SQL_HANDLE_ENV, NULL, &henv);
retcode = SQLSetEnvAttr(henv, SQL_ATTR_ODBC_VERSION,(SQLPOINTER) SQL_OV_ODBC3, SQL_IS_INTEGER);
retcode = SQLAllocHandle(SQL_HANDLE_DBC, henv, &hdbc1);
retcode = SQLConnect(hdbc1, szDSN,SQL_NTS,szUID,SQL_NTS,szAuthStr,SQL_NTS);
retcode = SQLAllocHandle(SQL_HANDLE_STMT, hdbc1, &hstmt1);

// Execute the select statement. Here it is assumed that numeric_test
//table is created using the following statements:

// Create table numeric_test (col1 numeric(5,3))
//insert into numeric_test values (25.212)

retcode = SQLExecDirect(hstmt1,(UCHAR *)"select * from numeric_test",SQL_NTS);

// Use SQLBindCol to bind the NumStr to the column that is being retrieved.

retcode = SQLBindCol(hstmt1,1,SQL_C_NUMERIC,&NumStr,19,&strlen1);

// Get the application row descriptor for the statement handle using
//SQLGetStmtAttr.

retcode = SQLGetStmtAttr(hstmt1, SQL_ATTR_APP_ROW_DESC,&hdesc, 0, NULL);

// You can either use SQLSetDescRec or SQLSetDescField when using
// SQLBindCol. However, if you prefer to call SQLGetData, you have to
// call SQLSetDescField instead of SQLSetDescRec. For more information on
// descriptors, please refer to the ODBC 3.0 Programmers reference or
// your Online documentation.

//Used when using SQLSetDescRec
//a=b=sizeof(NumStr);

// Set the datatype, precision and scale fields of the descriptor for the 
//numeric column. Otherwise the default precision (driver defined) and 
//scale (0) are returned.

// In this case, the table contains only one column, hence the second 
//parameter contains one. Zero applies to bookmark columns. Please check 
//the programmers guide for more information.

//retcode=SQLSetDescRec(hdesc,1,SQL_NUMERIC,NULL,sizeof(NumStr),5,3,&NumStr,&a,&b);

retcode = SQLSetDescField (hdesc,1,SQL_DESC_TYPE,(VOID*)SQL_C_NUMERIC,0);
retcode = SQLSetDescField (hdesc,1,SQL_DESC_PRECISION,(VOID*) 5,0);
retcode = SQLSetDescField (hdesc,1,SQL_DESC_SCALE,(VOID*) 3,0);
    
// Initialize the val array in the numeric structure.

memset(NumStr.val,0,16);
   
// Call SQLFetch to fetch the first record.

while((retcode =SQLFetch(hstmt1)) != SQL_NO_DATA)
  {
// Notice that the TargetType (3rd Parameter) is SQL_ARD_TYPE, which  
//forces the driver to use the Application Row Descriptor with the 
//specified scale and precision.

   retcode = SQLGetData(hstmt1, 1, SQL_ARD_TYPE, &NumStr, 19, &a); 

// Check for null indicator.

   if ( SQL_NULL_DATA == a )
   {
   printf( "The final value: NULL\n" );
   continue;
   }

// Call to convert the little endian mode data into numeric data.

   myvalue = strtohextoval();

// The returned value in the above code is scaled to the value specified
//in the scale field of the numeric structure. For example 25.212 would
//be returned as 25212. The scale in this case is 3 hence the integer 
//value needs to be divided by 1000.

   divisor = 1;
   if(NumStr.scale > 0)
     {
    for (i=0;i< NumStr.scale; i++)   
         divisor = divisor * 10;
     }
   final_val =  (float) myvalue /(float) divisor;

// Examine the sign value returned in the sign field for the numeric
//structure.
//NOTE: The ODBC 3.0 spec required drivers to return the sign as 
//1 for positive numbers and 2 for negative number. This was changed in the
//ODBC 3.5 spec to return 0 for negative instead of 2.

      if(!NumStr.sign) sign = -1;
      else sign  =1;

   final_val *= sign;
   printf("The final value: %f\n",final_val);
    }

   while ( ( retcode = SQLMoreResults(hstmt1) ) != SQL_NO_DATA_FOUND);

   /* clean up */ 
   SQLFreeHandle(SQL_HANDLE_STMT, hstmt1);
   SQLDisconnect(hdbc1);
   SQLFreeHandle(SQL_HANDLE_DBC, hdbc1);
   SQLFreeHandle(SQL_HANDLE_ENV, henv);
   return(0);
}

중간 결과:

//  C  ==> 12 * 1    =     12
//  7  ==> 07 * 16   =    112
//  2  ==> 02 * 256  =    512
//  6  ==> 06 * 4096 =  24576
===============================
                 Sum =  25212

숫자 구조에서 val 필드는 16개 요소의 문자 배열입니다. 예를 들어 25.212는 25212로 조정되고 배율은 3입니다. 16진수 형식으로 이 숫자는 627C입니다.

드라이버는 다음 항목을 반환합니다.

'|'인 7C의 해당 문자입니다. 문자 배열의 첫 번째 요소에 있는 (파이프)
두 번째 요소의 'b'인 62에 해당합니다.
배열 요소의 re기본ders에는 0이 포함되므로 버퍼에는 '|b\0'이 포함됩니다.

이제 이 문자열 배열에서 크기가 조정된 정수를 생성하는 것이 과제입니다. 문자열의 각 문자는 LSD(최소 유효 자릿수) 및 MSD(가장 중요한 숫자)와 같은 두 개의 16진수 자릿수에 해당합니다. 크기 조정된 정수 값은 각 숫자(LSD 및 MSD)를 1부터 16의 배수로 곱하여 생성할 수 있습니다.

little endian 모드에서 크기 조정된 정수로 변환을 구현하는 코드입니다. 이 기능을 구현하는 것은 애플리케이션 개발자의 책임입니다. 다음 코드 예제는 가능한 여러 가지 방법 중 하나일 뿐입니다.

long strtohextoval()
{
    long val=0,value=0;
    int i=1,last=1,current;
    int a=0,b=0;

        for(i=0;i<=15;i++)
        {
         current = (int) NumStr.val[i];
         a= current % 16; //Obtain LSD
         b= current / 16; //Obtain MSD
            
         value += last* a;   
         last = last * 16;   
         value += last* b;
         last = last * 16;   
        }
     return value;
}

버전에 적용

SQL_NUMERIC_STRUCT 대한 이전 정보는 다음 제품 버전에 적용됩니다.

Microsoft ODBC Driver for Microsoft SQL Server 3.7
Microsoft 데이터 액세스 구성 요소 2.1
Microsoft 데이터 액세스 구성 요소 2.5
Microsoft 데이터 액세스 구성 요소 2.6
Microsoft 데이터 액세스 구성 요소 2.7

SQL_C_NUMERIC 개요

다음 샘플 프로그램은 테이블에 123.45를 삽입하여 SQL_C_NUMERIC 사용하는 방법을 보여 줍니다. 테이블에서 열은 숫자 또는 소수로 정의되고 전체 자릿수는 5이고 소수 자릿수는 2입니다.

이 프로그램을 실행하는 데 사용하는 ODBC 드라이버는 ODBC 3.0 기능을 지원해야 합니다.

#include <windows.h>
#include <sql.h>
#include <sqlext.h>

void main() {

   SQLHENV    henv  = NULL;
   SQLHDBC    hdbc  = NULL;
   SQLHSTMT   hstmt = NULL;

   SQL_NUMERIC_STRUCT   NumStr;
   SQLINTEGER           cbNumStr = sizeof (NumStr);

   SQLAllocHandle(SQL_HANDLE_ENV, NULL, &henv);

   /* Set the ODBC behavior version. */ 
   SQLSetEnvAttr(henv,
         SQL_ATTR_ODBC_VERSION,
         (SQLPOINTER) SQL_OV_ODBC3,
         SQL_IS_INTEGER);

   SQLAllocHandle(SQL_HANDLE_DBC, henv, &hdbc);

   /* Substitute your own connection information */ 
   SQLConnect(hdbc,
      (SQLCHAR *) "MyDSN", 5,
      (SQLCHAR *) "UserID", 6,
      (SQLCHAR *) "Password", 8);

   SQLAllocHandle(SQL_HANDLE_STMT, hdbc, &hstmt);

   /*
      Set up the SQL_NUMERIC_STRUCT, NumStr, to hold "123.45".

      First, we need to scale 123.45 to an integer: 12345
      One way to switch the bytes is to convert 12345 to Hex:  0x3039
      Since the least significant byte will be stored starting from the
      leftmost byte, "0x3039" will be stored as "0x3930".

      The precision and scale fields are not used for input to the driver,
      only for output from the driver. The precision and scale will be set
      in the application parameter descriptor later.
   */ 

   NumStr.sign = 1;   /* 1 if positive, 2 if negative */ 

   memset (NumStr.val, 0, 16);
   NumStr.val [0] = 0x39;
   NumStr.val [1] = 0x30;

   /* SQLBindParameter needs to be called before SQLSetDescField */ 
   SQLBindParameter(hstmt,
          1,
          SQL_PARAM_INPUT,
          SQL_C_NUMERIC,
          SQL_NUMERIC,
          5,
          2,
          &NumStr,
          0,
          (SQLINTEGER *) &cbNumStr);

   /* Modify the fields in the implicit application parameter descriptor */ 
   SQLHDESC   hdesc = NULL;

   SQLGetStmtAttr(hstmt, SQL_ATTR_APP_PARAM_DESC, &hdesc, 0, NULL);
   SQLSetDescField(hdesc, 1, SQL_DESC_TYPE, (SQLPOINTER) SQL_C_NUMERIC, 0);
   SQLSetDescField(hdesc, 1, SQL_DESC_PRECISION, (SQLPOINTER) 5, 0);
   SQLSetDescField(hdesc, 1, SQL_DESC_SCALE, (SQLPOINTER) 2, 0);
   SQLSetDescField(hdesc, 1, SQL_DESC_DATA_PTR, (SQLPOINTER) &NumStr, 0);

   SQLExecDirect(hstmt,
         (SQLCHAR *) "INSERT INTO table (numeric_column) VALUES (?)",
         SQL_NTS);

   SQLFreeHandle(SQL_HANDLE_STMT, hstmt);

   SQLDisconnect (hdbc);

   SQLFreeHandle(SQL_HANDLE_DBC, hdbc);
   SQLFreeHandle(SQL_HANDLE_ENV, henv);
}

다음을 통해 공유