创建 SQL Server Native Client Indexes

适用于:SQL Server Azure SQL 数据库 Azure SQL 托管实例 Azure Synapse Analytics Analytics 平台系统(PDW)

SQL Server Native Client OLE DB 访问接口公开 IIndexDefinition::CreateIndex 函数,使使用者能够在 SQL Server 表上定义新索引。

SQL Server Native Client OLE DB 访问接口将表索引创建为索引或约束。 SQL Server 向表所有者、数据库所有者和某些管理角色的成员提供约束创建特权。 默认情况下,只有表所有者才能对表创建索引。 因此,CreateIndex 的成功或失败不仅取决于应用程序用户的访问权限,还取决于所创建索引的类型 。

在 pTableID 参数的 uName 联合的 pwszName 成员中,使用者将表名指定为 Unicode 字符串 。 pTableID 的 eKind 成员必须是 DBKIND_NAME 。

pIndexID 参数可以为 NULL,如果是,SQL Server Native Client OLE DB 访问接口将为索引创建唯一名称。 通过在 ppIndexID 参数中指定一个指向 DBID 的有效指针,使用者可以捕获索引的名称 。

在 pIndexID 参数的 uName 联合的 pwszName 成员中,使用者可以将索引名称指定为 Unicode 字符串 。 pIndexID 的 eKind 成员必须是 DBKIND_NAME 。

使用者按名称指定参与索引的一个或多个列。 对于在 CreateIndex 中使用的每个 DBINDEXCOLUMNDESC 结构,pColumnID 的 eKind 成员必须为 DBKIND_NAME 。 在 pColumnID 的 uName 联合的 pwszName 成员中,列名指定为 Unicode 字符串 。

SQL Server Native Client OLE DB 访问接口和 SQL Server 支持索引中值的升序。 如果使用者在任何 DBINDEXCOLUMNDESC 结构中指定DBINDEX_COL_ORDER_DESC,则 SQL Server Native Client OLE DB 访问接口返回E_INVALIDARG。

CreateIndex 对索引属性的解释如下 。

属性 ID 说明
DBPROP_INDEX_AUTOUPDATE R/W:读取/写入

默认值:无

说明:SQL Server Native Client OLE DB 访问接口不支持此属性。 尝试在 CreateIndex 中设置此属性将导致出现 DB_S_ERRORSOCCURRED 返回值 。 此属性结构的 dwStatus 成员指示 DBPROPSTATUS_BADVALUE 。
DBPROP_INDEX_CLUSTERED R/W:读取/写入

默认值:VARIANT_FALSE

说明:控制索引聚类分析。

VARIANT_TRUE:SQL Server Native Client OLE DB 访问接口尝试在 SQL Server 表上创建聚集索引。 SQL Server 支持对任何表最多创建一个聚集索引。

VARIANT_FALSE:SQL Server Native Client OLE DB 访问接口尝试在 SQL Server 表上创建非聚集索引。
DBPROP_INDEX_FILLFACTOR R/W:读取/写入

默认值:0

说明:指定用于存储的索引页所占的百分比。 有关详细信息,请参阅创建索引

变量类型为 VT_I4。 该值必须大于或等于 1 且小于或等于 100。
DBPROP_INDEX_INITIALIZE R/W:读取/写入

默认值:无

说明:SQL Server Native Client OLE DB 访问接口不支持此属性。 尝试在 CreateIndex 中设置此属性将导致出现 DB_S_ERRORSOCCURRED 返回值 。 此属性结构的 dwStatus 成员指示 DBPROPSTATUS_BADVALUE 。
DBPROP_INDEX_NULLCOLLATION R/W:读取/写入

默认值:无

说明:SQL Server Native Client OLE DB 访问接口不支持此属性。 尝试在 CreateIndex 中设置此属性将导致出现 DB_S_ERRORSOCCURRED 返回值 。 此属性结构的 dwStatus 成员指示 DBPROPSTATUS_BADVALUE 。
DBPROP_INDEX_NULLS R/W:读取/写入

默认值:无

说明:SQL Server Native Client OLE DB 访问接口不支持此属性。 尝试在 CreateIndex 中设置此属性将导致出现 DB_S_ERRORSOCCURRED 返回值 。 此属性结构的 dwStatus 成员指示 DBPROPSTATUS_BADVALUE 。
DBPROP_INDEX_PRIMARYKEY R/W:读取/写入

默认值:VARIANT_FALSE 说明:将该索引创建为引用完整性 PRIMARY KEY 约束。

VARIANT_TRUE:创建该索引是为了支持表的 PRIMARY KEY 约束。 列必须不可为 Null。

VARIANT_FALSE:该索引不作为表中行值的 PRIMARY KEY 约束使用。
DBPROP_INDEX_SORTBOOKMARKS R/W:读取/写入

默认值:无

说明:SQL Server Native Client OLE DB 访问接口不支持此属性。 尝试在 CreateIndex 中设置此属性将导致出现 DB_S_ERRORSOCCURRED 返回值 。 此属性结构的 dwStatus 成员指示 DBPROPSTATUS_BADVALUE 。
DBPROP_INDEX_TEMPINDEX R/W:读取/写入

默认值:无

说明:SQL Server Native Client OLE DB 访问接口不支持此属性。 尝试在 CreateIndex 中设置此属性将导致出现 DB_S_ERRORSOCCURRED 返回值 。 此属性结构的 dwStatus 成员指示 DBPROPSTATUS_BADVALUE 。
DBPROP_INDEX_TYPE R/W:读取/写入

默认值:无

说明:SQL Server Native Client OLE DB 访问接口不支持此属性。 尝试在 CreateIndex 中设置此属性将导致出现 DB_S_ERRORSOCCURRED 返回值 。 此属性结构的 dwStatus 成员指示 DBPROPSTATUS_BADVALUE 。
DBPROP_INDEX_UNIQUE R/W:读取/写入

默认值:VARIANT_FALSE

说明:对参与的一个或多个列将该索引创建为 UNIQUE 约束。

VARIANT_TRUE:该索引用于唯一约束表中的行值。

VARIANT_FALSE:该索引不对行值进行唯一约束。

在提供程序特定的属性集中DBPROPSET_SQLSERVERINDEX,SQL Server Native Client OLE DB 访问接口定义以下数据源信息属性。

属性 ID 说明
SSPROP_INDEX_XML 键入:VT_BOOL (R/W)

默认值:VARIANT_FALSE

说明:当使用 IIndexDefinition::CreateIndex 将此属性指定为值 VARIANT_TRUE 时,将导致创建与被索引的列对应的主 XML 索引。 如果此属性为 VARIANT_TRUE,则 cIndexColumnDescs 应为 1,否则将会出错。

本示例创建了一个主键索引:

// This CREATE TABLE statement shows the referential integrity and   
// PRIMARY KEY constraint on the OrderDetails table that will be 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  
// )  
//  
HRESULT CreatePrimaryKey  
    (  
    IIndexDefinition* pIIndexDefinition  
    )  
    {  
    HRESULT             hr = S_OK;  
  
    DBID                dbidTable;  
    DBID                dbidIndex;  
    const ULONG         nCols = 2;  
    ULONG               nCol;  
    const ULONG         nProps = 2;  
    ULONG               nProp;  
  
    DBINDEXCOLUMNDESC   dbidxcoldesc[nCols];  
    DBPROP              dbpropIndex[nProps];  
    DBPROPSET           dbpropset;  
  
    DBID*               pdbidIndexOut = NULL;  
  
    // Set up identifiers for the table and index.  
    dbidTable.eKind = DBKIND_NAME;  
    dbidTable.uName.pwszName = L"OrderDetails";  
  
    dbidIndex.eKind = DBKIND_NAME;  
    dbidIndex.uName.pwszName = L"PK_OrderDetails";  
  
    // Set up column identifiers.  
    for (nCol = 0; nCol < nCols; nCol++)  
        {  
        dbidxcoldesc[nCol].pColumnID = new DBID;  
        dbidxcoldesc[nCol].pColumnID->eKind = DBKIND_NAME;  
  
        dbidxcoldesc[nCol].eIndexColOrder = DBINDEX_COL_ORDER_ASC;  
        }  
    dbidxcoldesc[0].pColumnID->uName.pwszName = L"OrderID";  
    dbidxcoldesc[1].pColumnID->uName.pwszName = L"ProductID";  
  
    // Set properties for the index. The index is clustered,  
    // PRIMARY KEY.  
    for (nProp = 0; nProp < nProps; nProp++)  
        {  
        dbpropIndex[nProp].dwOptions = DBPROPOPTIONS_REQUIRED;  
        dbpropIndex[nProp].colid = DB_NULLID;  
  
        VariantInit(&(dbpropIndex[nProp].vValue));  
  
        dbpropIndex[nProp].vValue.vt = VT_BOOL;  
        }  
    dbpropIndex[0].dwPropertyID = DBPROP_INDEX_CLUSTERED;  
    dbpropIndex[0].vValue.boolVal = VARIANT_TRUE;  
  
    dbpropIndex[1].dwPropertyID = DBPROP_INDEX_PRIMARYKEY;  
    dbpropIndex[1].vValue.boolVal = VARIANT_TRUE;  
  
    dbpropset.rgProperties = dbpropIndex;  
    dbpropset.cProperties = nProps;  
    dbpropset.guidPropertySet = DBPROPSET_INDEX;  
  
    hr = pIIndexDefinition->CreateIndex(&dbidTable, &dbidIndex, nCols,  
        dbidxcoldesc, 1, &dbpropset, &pdbidIndexOut);  
  
    // Clean up dynamically allocated DBIDs.  
    for (nCol = 0; nCol < nCols; nCol++)  
        {  
        delete dbidxcoldesc[nCol].pColumnID;  
        }  
  
    return (hr);  
    }  

另请参阅

表和索引