SQL Server テーブルの作成

SQL Server Native Client OLE DB プロバイダーは ITableDefinition::CreateTable 関数を公開し、コンシューマーが SQL Server テーブルを作成できるようにします。 コンシューマーは 、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 に設定し、ppTableID が有効な DBID* を指すように設定すると、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 でのデータ型マッピング」を参照してください。

コンシューマーは、DBCOLUMNDESC dbcid メンバーの uName 共用体の pwszName メンバーの列名を指定します。 列名は Unicode 文字列として指定されます。 dbcid の eKind メンバーがDBKIND_NAMEされている必要があります。 CreateTable は、 eKind が無効な場合、 pwszName が NULL の場合、または pwszName の値が有効な SQL Server 識別子でない場合に、DB_E_BADCOLUMNIDを返します。

すべての列プロパティは、テーブルに対して定義されているすべての列で使用できます。 CreateTable は、プロパティ値が競合して設定されている場合、DB_S_ERRORSOCCURREDまたはDB_E_ERRORSOCCURREDを返すことができます。 列プロパティの設定が無効な場合、SQL Server テーブルの作成エラーが発生すると、CreateTable からエラーが返されます。

DBCOLUMNDESC の列プロパティは、次のように解釈されます。

コンシューマーが ITableDefinition::CreateTable を呼び出すと、SQL Server Native Client OLE DB プロバイダーはテーブルのプロパティを次のように解釈します。

コンシューマーが、正常に作成されたテーブルで行セットを開く必要がある場合、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);  
    }  

こちらもご覧ください

テーブルとインデックス