SQL Server 테이블 만들기

SQL Server Native Client OLE DB 공급자는 소비자가 SQL Server 테이블을 만들 수 있도록 ITableDefinition::CreateTable 함수를 제공합니다. 소비자는 CreateTable을 사용하여 소비자가 명명한 영구 테이블을 만들거나 SQL Server Native Client OLE DB 공급자가 생성한 고유한 이름을 가진 영구 또는 임시 테이블을 만듭니다.

소비자가 ITableDefinition::CreateTable을 호출하는데 DBPROP_TBL_TEMPTABLE 속성 값이 VARIANT_TRUE이면 SQL Server Native Client OLE DB 공급자가 소비자 대신 임시 테이블 이름을 생성합니다. 소비자는 CreateTable 메서드의 pTableID 매개 변수를 NULL로 설정합니다. SQL Server Native Client OLE DB 공급자가 생성한 이름을 가진 임시 테이블은 TABLES 행 집합에 나타나지 않지만 IOpenRowset 인터페이스를 통해 액세스할 수 있습니다.

소비자가 pTableID 매개 변수에서 uName 공용 구조체의 pwszName 멤버에 테이블 이름을 지정하면 SQL Server Native Client OLE DB 공급자가 해당 이름으로 SQL Server 테이블을 만듭니다. 이때 SQL Server 테이블 명명 제약 조건이 적용되며 테이블 이름은 영구 테이블이나 로컬 또는 전역 임시 테이블을 나타낼 수 있습니다. 자세한 내용은 CREATE TABLE을 참조하십시오. ppTableID 매개 변수는 NULL일 수 있습니다.

SQL Server Native Client OLE DB 공급자는 영구 또는 임시 테이블의 이름을 생성할 수 있습니다. 소비자가 pTableID 매개 변수를 NULL로 설정하고 올바른 DBID*를 가리키도록 ppTableID를 설정한 경우 SQL Server Native Client OLE DB 공급자는 ppTableID 값이 가리키는 DBID의 uName 공용 구조체의 pwszName 멤버에 있는 테이블에 대해 생성된 이름을 반환합니다. SQL Server Native Client OLE DB 공급자가 명명한 임시 테이블을 만들려면 소비자가 rgPropertySets 매개 변수에서 참조하는 테이블 속성 집합에 OLE DB 테이블 속성 DBPROP_TBL_TEMPTABLE을 포함해야 합니다. SQL Server Native Client OLE DB 공급자가 명명한 임시 테이블은 로컬 테이블입니다.

pTableID 매개 변수의 eKind 멤버가 DBKIND_NAME을 나타내지 않으면 CreateTable이 DB_E_BADTABLEID를 반환합니다.

DBCOLUMNDESC 사용

소비자는 pwszTypeName 멤버나 wType 멤버를 사용하여 열 데이터 형식을 나타낼 수 있습니다. 소비자가 pwszTypeName에 데이터 형식을 지정하면 SQL Server Native Client OLE DB 공급자가 wType 값을 무시합니다.

pwszTypeName 멤버를 사용하는 경우 소비자는 SQL Server 데이터 형식 이름을 사용하여 데이터 형식을 지정합니다. 올바른 데이터 형식 이름은 PROVIDER_TYPES 스키마 행 집합의 TYPE_NAME 열에 반환되는 값입니다.

SQL Server Native Client OLE DB 공급자는 wType 멤버에 있는 OLE DB가 열거하는 DBTYPE 값의 하위 집합을 인식합니다. 자세한 내용은 ITableDefinition의 데이터 형식 매핑을 참조하십시오.

[!참고]

소비자가 pTypeInfo 또는 pclsid 멤버를 설정하여 열 데이터 형식을 지정하면 CreateTable이 DB_E_BADTYPE을 반환합니다.

소비자는 DBCOLUMNDESC dbcid 멤버의 uName 공용 구조체에 있는 pwszName 멤버에 열 이름을 지정합니다. 열 이름은 유니코드 문자열로 지정합니다. dbcid의 eKind 멤버는 DBKIND_NAME이어야 합니다. eKind가 올바르지 않고 pwszName이 NULL이거나 pwszName 값이 올바른 SQL Server 식별자가 아니면 CreateTable이 DB_E_BADCOLUMNID를 반환합니다.

모든 열 속성을 테이블에 대해 정의된 모든 열에 사용할 수 있습니다. 속성 값 설정이 충돌될 경우 CreateTable이 DB_S_ERRORSOCCURRED 또는 DB_E_ERRORSOCCURRED를 반환할 수 있습니다. 잘못된 열 속성 설정으로 인해 SQL Server 테이블 생성에 실패할 경우 CreateTable이 오류를 반환합니다.

DBCOLUMNDESC의 열 속성이 나타내는 의미는 다음과 같습니다.

속성 ID	설명
DBPROP_COL_AUTOINCREMENT	R/W: 읽기/쓰기 기본값: VARIANT_FALSE 설명: 생성된 열에 대한 ID 속성을 설정합니다. SQL Server에서 ID 속성은 테이블 내의 단일 열에 대해서만 유효합니다. 두 개 이상의 열에 대해 이 속성을 VARIANT_TRUE로 설정하면 SQL Server Native Client OLE DB 공급자가 서버에서 테이블을 만들려고 할 때 오류가 발생합니다. SQL Server ID 속성은 소수 자릿수가 0인 integer, numeric 및 decimal 형식에 대해서만 유효합니다. 다른 데이터 형식의 열에서 이 속성을 VARIANT_TRUE로 설정하면 SQL Server Native Client OLE DB 공급자가 서버에서 테이블을 만들려고 할 때 오류가 발생합니다. DBPROP_COL_AUTOINCREMENT 및 DBPROP_COL_NULLABLE이 모두 VARIANT_TRUE이고 DBPROP_COL_NULLABLE의 dwOption이 DBPROPOPTIONS_REQUIRED가 아니면 SQL Server Native Client OLE DB 공급자가 DB_S_ERRORSOCCURRED를 반환합니다. DBPROP_COL_AUTOINCREMENT 및 DBPROP_COL_NULLABLE이 모두 VARIANT_TRUE이고 DBPROP_COL_NULLABLE의 dwOption이 DBPROPOPTIONS_REQUIRED이면 DB_E_ERRORSOCCURRED가 반환됩니다. SQL Server ID 속성을 사용하여 열이 정의되고 DBPROP_COL_NULLABLE dwStatus 멤버가 DBPROPSTATUS_CONFLICTING으로 설정됩니다.
DBPROP_COL_DEFAULT	R/W: 읽기/쓰기 기본값: 없음 설명: 열에 대해 SQL Server DEFAULT 제약 조건을 만듭니다. vValue DBPROP 멤버에는 개수에 관계없이 유형을 얼마든지 지정할 수 있습니다. vValue.vt 멤버에는 열 데이터 형식과 호환되는 유형을 지정해야 합니다. 예를 들어 DBTYPE_WSTR로 정의된 열의 기본값으로 BSTR N/A를 정의하는 것은 서로 호환되므로 가능합니다. DBTYPE_R8로 정의된 열에 위와 같은 기본값을 정의하면 SQL Server Native Client OLE DB 공급자가 서버에서 테이블을 만들려고 할 때 오류가 발생합니다.
DBPROP_COL_DESCRIPTION	R/W: 읽기/쓰기 기본값: 없음 설명: DBPROP_COL_DESCRIPTION 열 속성은 SQL Server Native Client OLE DB 공급자에 의해 구현되지 않습니다. 소비자가 속성 값을 쓰려고 하면 DBPROP 구조의 dwStatus 멤버가 DBPROPSTATUS_NOTSUPPORTED를 반환합니다. 이 속성을 설정해도 SQL Server Native Client OLE DB 공급자에서 오류가 발생하지는 않습니다. 다른 매개 변수 값이 모두 올바르기만 하면 SQL Server 테이블이 생성됩니다.
DBPROP_COL_FIXEDLENGTH	R/W: 읽기/쓰기 기본값: VARIANT_FALSE 설명: 소비자가 DBCOLUMNDESC의 wType 멤버를 사용하여 열의 데이터 형식을 정의한 경우 SQL Server Native Client OLE DB 공급자는 DBPROP_COL_FIXEDLENGTH를 통해 데이터 형식 매핑을 확인합니다. 자세한 내용은 ITableDefinition의 데이터 형식 매핑을 참조하십시오.
DBPROP_COL_NULLABLE	R/W: 읽기/쓰기 기본값: 없음 설명: 테이블을 만들 때 SQL Server Native Client OLE DB 공급자가 열의 null 값 허용 여부를 나타냅니다(해당 속성이 설정된 경우). 해당 속성이 설정되어 있지 않으면 열의 NULL 값 허용 여부가 SQL Server ANSI_NULLS 기본 데이터베이스 옵션을 통해 확인됩니다. SQL Server Native Client OLE DB 공급자는 ISO 규격 공급자입니다. 연결된 세션에서는 ISO 동작을 따르므로 소비자가 DBPROP_COL_NULLABLE을 설정하지 않은 경우 열은 null 값을 허용합니다.
DBPROP_COL_PRIMARYKEY	R/W: 읽기/쓰기 기본값: VARIANT_FALSE 설명: VARIANT_TRUE인 경우 SQL Server Native Client OLE DB 공급자가 PRIMARY KEY 제약 조건이 있는 열을 만듭니다. 열 속성으로 정의된 경우 단일 열만 이 제약 조건을 확인할 수 있습니다. 두 개 이상의 열에 VARIANT_TRUE 속성을 설정하면 SQL Server Native Client OLE DB 공급자가 SQL Server 테이블을 만들려고 할 때 오류가 반환됩니다. 참고: 소비자는 IIndexDefinition::CreateIndex를 사용하여 둘 이상의 열에 대해 PRIMARY KEY 제약 조건을 만들 수 있습니다. DBPROP_COL_PRIMARYKEY 및 DBPROP_COL_UNIQUE가 모두 VARIANT_TRUE이고 DBPROP_COL_UNIQUE의 dwOption이 DBPROPOPTIONS_REQUIRED가 아니면 SQL Server Native Client OLE DB 공급자가 DB_S_ERRORSOCCURRED를 반환합니다. DBPROP_COL_PRIMARYKEY 및 DBPROP_COL_UNIQUE가 모두 VARIANT_TRUE이고 DBPROP_COL_UNIQUE의 dwOption이 DBPROPOPTIONS_REQUIRED이면 DB_E_ERRORSOCCURRED가 반환됩니다. SQL Server ID 속성을 사용하여 열이 정의되고 DBPROP_COL_PRIMARYKEY dwStatus 멤버가 DBPROPSTATUS_CONFLICTING으로 설정됩니다. DBPROP_COL_PRIMARYKEY 및 DBPROP_COL_NULLABLE이 모두 VARIANT_TRUE이면 SQL Server Native Client OLE DB 공급자가 오류를 반환합니다. 소비자가 잘못된 SQL Server 데이터 형식 열에 대해 PRIMARY KEY 제약 조건을 만들려고 하면 SQL Server Native Client OLE DB 공급자가 SQL Server에서 오류를 반환합니다. bit, text, ntext, image 등의 SQL Server 데이터 형식을 사용하여 만든 열에 대해서는 PRIMARY KEY 제약 조건을 정의할 수 없습니다.
DBPROP_COL_UNIQUE	R/W: 읽기/쓰기 기본값: VARIANT_FALSE 설명: 열에 SQL Server UNIQUE 제약 조건을 적용합니다. 열 속성으로 정의된 경우 이 제약 조건은 단일 열에만 적용됩니다. 소비자는 IIndexDefinition::CreateIndex를 사용하여 둘 이상의 결합된 열 값에 대해 UNIQUE 제약 조건을 적용할 수 있습니다. DBPROP_COL_PRIMARYKEY 및 DBPROP_COL_UNIQUE가 모두 VARIANT_TRUE이고 dwOption이 DBPROPOPTIONS_REQUIRED가 아니면 SQL Server Native Client OLE DB 공급자가 DB_S_ERRORSOCCURRED를 반환합니다. DBPROP_COL_PRIMARYKEY 및 DBPROP_COL_UNIQUE가 모두 VARIANT_TRUE이고 dwOption이 DBPROPOPTIONS_REQUIRED이면 DB_E_ERRORSOCCURRED가 반환됩니다. SQL Server ID 속성을 사용하여 열이 정의되고 DBPROP_COL_PRIMARYKEY dwStatus 멤버가 DBPROPSTATUS_CONFLICTING으로 설정됩니다. DBPROP_COL_NULLABLE 및 DBPROP_COL_UNIQUE가 모두 VARIANT_TRUE이고 dwOption이 DBPROPOPTIONS_REQUIRED가 아니면 SQL Server Native Client OLE DB 공급자가 DB_S_ERRORSOCCURRED를 반환합니다. DBPROP_COL_NULLABLE 및 DBPROP_COL_UNIQUE가 모두 VARIANT_TRUE이고 dwOption이 DBPROPOPTIONS_REQUIRED이면 DB_E_ERRORSOCCURRED가 반환됩니다. SQL Server ID 속성을 사용하여 열이 정의되고 DBPROP_COL_NULLABLE dwStatus 멤버가 DBPROPSTATUS_CONFLICTING으로 설정됩니다. 소비자가 잘못된 SQL Server 데이터 형식 열에 대해 UNIQUE 제약 조건을 만들려고 하면 SQL Server Native Client OLE DB 공급자가 SQL Server에서 오류를 반환합니다. SQL Server bit 데이터 형식을 사용하여 만든 열에 대해서는 UNIQUE 제약 조건을 정의할 수 없습니다.

소비자가 ITableDefinition::CreateTable을 호출하면 SQL Server Native Client OLE DB 공급자는 테이블 속성을 다음과 같이 해석합니다.

속성 ID	설명
DBPROP_TBL_TEMPTABLE	R/W: 읽기/쓰기 기본값: VARIANT_FALSE 설명: SQL Server Native Client OLE DB 공급자가 기본적으로 소비자가 명명한 테이블을 만듭니다. VARIANT_TRUE일 경우 SQL Server Native Client OLE DB 공급자가 소비자 대신 임시 테이블 이름을 생성합니다. 소비자는 CreateTable의 pTableID 매개 변수를 NULL로 설정합니다. ppTableID 매개 변수에는 올바른 포인터를 포함해야 합니다.

소비자가 성공적으로 생성된 테이블에서 행 집합을 열도록 요청하면 SQL Server Native Client OLE DB 공급자는 커서 지원 행 집합을 엽니다. 행 집합 속성은 전달하는 속성 집합에서 표시할 수 있습니다.

이 예에서는 SQL Server 테이블을 만듭니다.

// This CREATE TABLE statement shows the details of the table created by 
// the following example code.
//
// CREATE TABLE OrderDetails
// (
//    OrderID      int      NOT NULL
//    ProductID   int      NOT NULL
//    CONSTRAINT PK_OrderDetails
//         PRIMARY KEY CLUSTERED (OrderID, ProductID),
//    UnitPrice   money      NOT NULL,
//    Quantity   int      NOT NULL,
//    Discount   decimal(2,2)   NOT NULL
//        DEFAULT 0
// )
//
// The PRIMARY KEY constraint is created in an additional example.
HRESULT CreateTable
    (
    ITableDefinition* pITableDefinition
    )
    {
    DBID            dbidTable;
    const ULONG     nCols = 5;
    ULONG           nCol;
    ULONG           nProp;
    DBCOLUMNDESC    dbcoldesc[nCols];
    
    HRESULT         hr;

    // Set up column descriptions. First, set default property values for
    //  the columns.
    for (nCol = 0; nCol < nCols; nCol++)
        {
        dbcoldesc[nCol].pwszTypeName = NULL;
        dbcoldesc[nCol].pTypeInfo = NULL;
        dbcoldesc[nCol].rgPropertySets = new DBPROPSET;
        dbcoldesc[nCol].pclsid = NULL;
        dbcoldesc[nCol].cPropertySets = 1;
        dbcoldesc[nCol].ulColumnSize = 0;
        dbcoldesc[nCol].dbcid.eKind = DBKIND_NAME;
        dbcoldesc[nCol].wType = DBTYPE_I4;
        dbcoldesc[nCol].bPrecision = 0;
        dbcoldesc[nCol].bScale = 0;

        dbcoldesc[nCol].rgPropertySets[0].rgProperties = 
            new DBPROP[NCOLPROPS_MAX];
        dbcoldesc[nCol].rgPropertySets[0].cProperties = NCOLPROPS_MAX;
        dbcoldesc[nCol].rgPropertySets[0].guidPropertySet =
            DBPROPSET_COLUMN;

        for (nProp = 0; nProp < NCOLPROPS_MAX; nProp++)
            {
            dbcoldesc[nCol].rgPropertySets[0].rgProperties[nProp].
                dwOptions = DBPROPOPTIONS_REQUIRED;
            dbcoldesc[nCol].rgPropertySets[0].rgProperties[nProp].colid
                 = DB_NULLID;

            VariantInit(
                &(dbcoldesc[nCol].rgPropertySets[0].rgProperties[nProp].
                    vValue));
            
            dbcoldesc[nCol].rgPropertySets[0].rgProperties[nProp].
                vValue.vt = VT_BOOL;
            }
        }

    // Set the column-specific information.
    dbcoldesc[0].dbcid.uName.pwszName = L"OrderID";
    dbcoldesc[0].rgPropertySets[0].rgProperties[0].dwPropertyID = 
        DBPROP_COL_NULLABLE;
    dbcoldesc[0].rgPropertySets[0].rgProperties[0].vValue.boolVal = 
        VARIANT_FALSE;
    dbcoldesc[0].rgPropertySets[0].cProperties = 1;

    dbcoldesc[1].dbcid.uName.pwszName = L"ProductID";
    dbcoldesc[1].rgPropertySets[0].rgProperties[0].dwPropertyID = 
        DBPROP_COL_NULLABLE;
    dbcoldesc[1].rgPropertySets[0].rgProperties[0].vValue.boolVal = 
        VARIANT_FALSE;
    dbcoldesc[1].rgPropertySets[0].cProperties = 1;

    dbcoldesc[2].dbcid.uName.pwszName = L"UnitPrice";
    dbcoldesc[2].wType = DBTYPE_CY;
    dbcoldesc[2].rgPropertySets[0].rgProperties[0].dwPropertyID = 
        DBPROP_COL_NULLABLE;
    dbcoldesc[2].rgPropertySets[0].rgProperties[0].vValue.boolVal = 
        VARIANT_FALSE;
    dbcoldesc[2].rgPropertySets[0].cProperties = 1;

    dbcoldesc[3].dbcid.uName.pwszName = L"Quantity";
    dbcoldesc[3].rgPropertySets[0].rgProperties[0].dwPropertyID = 
        DBPROP_COL_NULLABLE;
    dbcoldesc[3].rgPropertySets[0].rgProperties[0].vValue.boolVal = 
        VARIANT_FALSE;
    dbcoldesc[3].rgPropertySets[0].cProperties = 1;

    dbcoldesc[4].dbcid.uName.pwszName = L"Discount";
    dbcoldesc[4].wType = DBTYPE_NUMERIC;
    dbcoldesc[4].bPrecision = 2;
    dbcoldesc[4].bScale = 2;
    dbcoldesc[4].rgPropertySets[0].rgProperties[0].dwPropertyID = 
        DBPROP_COL_NULLABLE;
    dbcoldesc[4].rgPropertySets[0].rgProperties[0].vValue.boolVal = 
        VARIANT_FALSE;
    dbcoldesc[4].rgPropertySets[0].rgProperties[1].dwPropertyID = 
        DBPROP_COL_DEFAULT;
    dbcoldesc[4].rgPropertySets[0].rgProperties[1].vValue.vt = VT_BSTR;
    dbcoldesc[4].rgPropertySets[0].rgProperties[1].vValue.bstrVal =
        SysAllocString(L"0");
    dbcoldesc[4].rgPropertySets[0].cProperties = 2;

    // Set up the dbid for OrderDetails.
    dbidTable.eKind = DBKIND_NAME;
    dbidTable.uName.pwszName = L"OrderDetails";

    if (FAILED(hr = pITableDefinition->CreateTable(NULL, &dbidTable,
        nCols, dbcoldesc, NULL, 0, NULL, NULL, NULL)))
        {
        DumpError(pITableDefinition, IID_ITableDefinition);
        goto SAFE_EXIT;
        }

SAFE_EXIT:
    // Clean up dynamic allocation in the property sets.
    for (nCol = 0; nCol < nCols; nCol++)
        {
        for (nProp = 0; nProp < NCOLPROPS_MAX; nProp++)
            {
            if (dbcoldesc[nCol].rgPropertySets[0].rgProperties[nProp].
                vValue.vt == VT_BSTR)
                {
                SysFreeString(dbcoldesc[nCol].rgPropertySets[0].
                    rgProperties[nProp].vValue.bstrVal);
                }
            }
        
        delete [] dbcoldesc[nCol].rgPropertySets[0].rgProperties;
        delete [] dbcoldesc[nCol].rgPropertySets;
        }
    
    return (hr);
    }

참고 항목

개념

테이블 및 인덱스