SQL Server-tabellen maken

Van toepassing op:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform Systeem (PDW)SQL-database in Microsoft Fabric

OLE DB-stuurprogramma downloaden

De OLE DB-driver voor SQL Server maakt de ITableDefinition::CreateTable-functie beschikbaar, waardoor consumenten SQL Server-tabellen kunnen maken. Consumenten gebruiken CreateTable om permanente tabellen met consumentennaam te maken, en permanente of tijdelijke tabellen met unieke namen die worden gegenereerd door de OLE DB-driver voor SQL Server.

Wanneer de consument ITableDefinition::CreateTable, en de waarde van de DBPROP_TBL_TEMPTABLE-eigenschap VARIANT_TRUE is, genereert de OLE DB Driver voor SQL Server een tijdelijke tabelnaam voor de consument. De consument zet de pTableID-parameter van de CreateTable-methode op NULL. De tijdelijke tabellen met namen die door de OLE DB-driver voor SQL Server worden gegenereerd, verschijnen niet in de TABLES-rijset , maar zijn toegankelijk via de IOpenRowset-interface .

Wanneer consumenten de tabelnaam specificeren in het pwszName-lid van de uName-unie in de pTableID-parameter , maakt de OLE DB-driver voor SQL Server een SQL Server-tabel met die naam aan. SQL Server-tabelnaambeperkingen zijn van toepassing, en de tabelnaam kan een permanente tabel aanduiden, of een lokale of globale tijdelijke tabel. Zie CREATE TABLEvoor meer informatie. De ppTableID-parameter kan NULL zijn.

De OLE DB Driver voor SQL Server kan de namen genereren van permanente of tijdelijke tabellen. Wanneer de consument de pTableID-parameter op NULL zet en ppTableID zet om naar een geldige DBID* te verwijzen, geeft de OLE DB-driver voor SQL Server de gegenereerde naam van de tabel terug in het pwszName-lid van de uName-unie van de DBID waarnaar wordt verwezen door de waarde ppTableID. Om een tijdelijke OLE DB-driver te creëren voor SQL Server-named table, neemt de consument de OLE DB-tabeleigenschap DBPROP_TBL_TEMPTABLE op in een tabel-eigenschapsset die wordt aangeduid in de rgPropertySets-parameter . OLE DB-driver voor tijdelijke tabellen met een naam SQL Server-naam zijn lokaal.

CreateTable geeft DB_E_BADTABLEID terug als het eKind-lid van de pTableID-parameter niet DBKIND_NAME aangeeft.

DBCOLUMNDESC-gebruik

De consument kan een kolomgegevenstype aangeven door gebruik te maken van het pwszTypeName-lid of het wType-lid . Als de consument het datatype specificeert in pwszTypeName, negeert de OLE DB-driver voor SQL Server de waarde van wType.

Bij gebruik van het pwszTypeName-lid , specificeert de consument het datatype door gebruik te maken van SQL Server-datatypenamen. Geldige datatypenamen zijn die welke worden teruggegeven in de TYPE_NAME kolom van de PROVIDER_TYPES schema-rijset.

De OLE DB Driver voor SQL Server herkent een deelverzameling van OLE DB-enumerated DBTYPE-waarden in het wType-lid . Voor meer informatie, zie Data Type Mapping in ITableDefinition.

De consument specificeert de kolomnaam in het pwszName-lid van de uName-unie van het DBCOLUMNDESC dbcid-lid . De kolomnaam wordt gespecificeerd als een Unicode-tekenreeks. Het eKind-lid van dbcid moet DBKIND_NAME zijn. CreateTable geeft DB_E_BADCOLUMNID terug als eKind ongeldig is, pwszName NULL is, of als de waarde van pwszName geen geldige SQL Server-identificatie is.

Alle kolomeigenschappen zijn beschikbaar op alle kolommen die voor de tabel zijn gedefinieerd. CreateTable kan DB_S_ERRORSOCCURRED of DB_E_ERRORSOCCURRED teruggeven als de eigenschappenwaarden in conflict zijn gezet. CreateTable geeft een foutmelding wanneer ongeldige kolom-eigenschapsinstellingen een fout veroorzaken bij het aanmaken van SQL Server-tabelen.

Kolomeigenschappen in een DBCOLUMNDESC worden als volgt geïnterpreteerd.

Wanneer de consument ITableDefinition::CreateTable aanroept, interpreteert de OLE DB-driver voor SQL Server de tabeleigenschappen als volgt.

Als de consument verzoekt om een rijset te openen op een succesvol gemaakte tabel, opent de OLE DB-driver voor SQL Server een door de cursor ondersteunde rijset. Eventuele eigenschappen van rijsets kunnen worden aangegeven in de doorgegeven eigenschappen.

Dit voorbeeld maakt een SQL Server-tabel aan.

// 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);  
    }  

Zie ook

Tabellen en indexen