Megjegyzés
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhat bejelentkezni vagy módosítani a címtárat.
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhatja módosítani a címtárat.
A következőkre vonatkozik:
SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics
Important
A SQL Server natív ügyfél (gyakran rövidített SNAC) el lett távolítva az SQL Server 2022 (16.x) és az SQL Server Management Studio 19 (SSMS) szolgáltatásból. Az SQL Server natív ügyféloldali OLE DB-szolgáltatója (SQLNCLI vagy SQLNCLI11) és az SQL Serverhez készült régi Microsoft OLE DB-szolgáltató (SQLOLEDB) nem ajánlott új fejlesztéshez. Váltson az új Microsoft OLE DB-illesztőprogramra (MSOLEDBSQL) az SQL Serverhez, és a jövőben is ezt használja.
Az SQL Server Native Client OLE DB szolgáltatója az OLE DB inicializációs és engedélyezési tulajdonságait a következőképpen értelmezi:
| Tulajdonságazonosító | Description |
|---|---|
| DBPROP_AUTH_CACHE_AUTHINFO | Az SQL Server Native Client OLE DB szolgáltató nem gyorsított hitelesítési információkat. A SQL Server Native Client OLE DB szolgáltató visszaadja DB_S_ERRORSOCCURRED-t a tulajdonság értékének beállítására tett kísérleten. A DBPROP szerkezet dwStatus tagja DBPROPSTATUS_NOTSUPPORTED-et jelöl. |
| DBPROP_AUTH_ENCRYPT_PASSWORD | Az SQL Server Native Client OLE DB szolgáltató szabványos Microsoft SQL Server biztonsági mechanizmusokat alkalmaz a jelszavak elrejtésére. A SQL Server Native Client OLE DB szolgáltató visszaadja DB_S_ERRORSOCCURRED-t a tulajdonság értékének beállítására tett kísérleten. A DBPROP szerkezet dwStatus tagja DBPROPSTATUS_NOTSUPPORTED-et jelöl. |
| DBPROP_AUTH_INTEGRATED | Ha DBPROP_AUTH_INTEGRATED NULL mutatóra, null stringre vagy 'SSPI' VT_BSTR értékre van beállítva, a SQL Server Native Client OLE DB szolgáltató Windows hitelesítési módot használ, hogy engedélyezze a felhasználók hozzáférését a DBPROP_INIT_DATASOURCE és DBPROP_INIT_CATALOG tulajdonságai által meghatározott SQL Server adatbázishoz. Ha VT_EMPTY-re van beállítva (az alapértelmezett beállítás), akkor SQL Server biztonságot használnak. Az SQL Server bejelentkezési és jelszó a DBPROP_AUTH_USERID és DBPROP_AUTH_PASSWORD tulajdonságokban van megadva. |
| DBPROP_AUTH_MASK_PASSWORD | Az SQL Server Native Client OLE DB szolgáltató szabványos SQL Server biztonsági mechanizmusokat alkalmaz a jelszavak elrejtésére. A SQL Server Native Client OLE DB szolgáltató visszaadja DB_S_ERRORSOCCURRED-t a tulajdonság értékének beállítására tett kísérleten. A DBPROP szerkezet dwStatus tagja DBPROPSTATUS_NOTSUPPORTED-et jelöl. |
| DBPROP_AUTH_PASSWORD | Jelszó egy SQL Server bejelentkezéshez rendelve. Ezt a tulajdonságot akkor használják, amikor az SQL Server hitelesítést kiválasztják az SQL Server adatbázishoz való hozzáférés engedélyezéséhez. |
| DBPROP_AUTH_PERSIST_ENCRYPTED | Az SQL Server Native Client OLE DB szolgáltató nem titkosítja a hitelesítési információkat, ha azok tartósan vannak. A SQL Server Native Client OLE DB szolgáltató visszaadja DB_S_ERRORSOCCURRED-t a tulajdonság értékének beállítására tett kísérleten. A DBPROP szerkezet dwStatus tagja DBPROPSTATUS_NOTSUPPORTED-et jelöl. |
| DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO | Az SQL Server Native Client OLE DB szolgáltató megtartja a hitelesítési értékeket, beleértve egy jelszó képét is, ha kérik. Titkosítás nem érhető el. |
| DBPROP_AUTH_USERID | SQL Server bejelentkezés. Ezt a tulajdonságot akkor használják, amikor az SQL Server hitelesítést kiválasztják az SQL Server adatbázishoz való hozzáférés engedélyezéséhez. |
| DBPROP_INIT_ASYNCH | Az SQL Server Native Client OLE DB szolgáltató támogatja az aszinkron indítást. Ha a DBPROPVAL_ASYNCH_INITIALIZE bit beállítva a DBPROP_INIT_ASYNCH tulajdonságban az IDBInitialize:::Initialize nem blokkoló hívássá válik. További információért lásd: Aszinkron műveletek végrehajtása. |
| DBPROP_INIT_CATALOG | Egy meglévő SQL Server adatbázis neve, amelyhez csatlakozni kell. |
| DBPROP_INIT_DATASOURCE | Egy Microsoft SQL Server példányt futtató szerver hálózati neve. Ha több SQL Server példány fut a számítógépen, egy adott SQL Server példányhoz való csatlakozáshoz az DBPROP_INIT_DATASOURCE értéket \ \ServerName\InstanceName-ként jelölik meg. Az escape sequence \\ magát a backslash-t használjuk. |
| DBPROP_INIT_GENERALTIMEOUT | Jelzi, hány másodperc a kérés előtt, az adatforrás inicializálásán és parancs végrehajtásán kívül, időlejáró lesz. 0 érték végtelen időkilépést jelez. Azok a szolgáltatók, amelyek hálózati kapcsolatokon vagy elosztott vagy tranzakciós helyzetekben dolgoznak, támogathatják ezt a tulajdonságot, hogy egy bejegyzett komponensnek időkorlátot jelezzenek hosszú távú kérés esetén. Az adatforrás inicializálásának és parancsvégrehajtásának időkorlátai továbbra is a DBPROP_INIT_TIMEOUT és a DBPROP_COMMANDTIMEOUT által szabályozott. DBPROP_INIT_GENERALTIMEOUT csak olvasható, és ha megpróbáljuk beállítani, a dwstatus hibája DBPROPSTATUS_NOTSETTABLE jelenik meg. |
| DBPROP_INIT_HWND | A Windows kezelő a hívó alkalmazásból származik. Érvényes ablak fogantyúra van szükség az inicializációs párbeszédablakhoz, amely akkor jelenik meg, amikor inicializációs tulajdonságokat kérnek. |
| DBPROP_INIT_IMPERSONATION_LEVEL | Az SQL Server Native Client OLE DB szolgáltató nem támogatja az impersonation szint módosítását. A SQL Server Native Client OLE DB szolgáltató visszaadja DB_S_ERRORSOCCURRED-t a tulajdonság értékének beállítására tett kísérleten. A DBPROP szerkezet dwStatus tagja DBPROPSTATUS_NOTSUPPORTED-et jelöl. |
| DBPROP_INIT_LCID | Az SQL Server Native Client OLE DB szolgáltató érvényesíti a helyi azonosítót, és hibát ad vissza, ha a helyazonosító nem támogatott vagy nincs telepítve a kliensre. |
| DBPROP_INIT_LOCATION | A SQL Server Native Client OLE DB szolgáltató visszaadja DB_S_ERRORSOCCURRED-t a tulajdonság értékének beállítására tett kísérleten. A DBPROP szerkezet dwStatus tagja DBPROPSTATUS_NOTSUPPORTED-et jelöl. |
| DBPROP_INIT_MODE | A SQL Server Native Client OLE DB szolgáltató visszaadja DB_S_ERRORSOCCURRED-t a tulajdonság értékének beállítására tett kísérleten. A DBPROP szerkezet dwStatus tagja DBPROPSTATUS_NOTSUPPORTED-et jelöl. |
| DBPROP_INIT_PROMPT | Az SQL Server Native Client OLE DB szolgáltató támogatja az összes adatforrás inicializációs prompting módot. A SQL Server Native Client OLE DB szolgáltató az DBPROMPT_NOPROMPT-t használja alapértelmezett beállításként a tulajdonsághoz. |
| DBPROP_INIT_PROTECTION_LEVEL | Az SQL Server Native Client OLE DB szolgáltatója nem támogatja az SQL Server egyes kapcsolataihoz való védelem szintjét. A SQL Server Native Client OLE DB szolgáltató visszaadja DB_S_ERRORSOCCURRED-t a tulajdonság értékének beállítására tett kísérleten. A DBPROP szerkezet dwStatus tagja DBPROPSTATUS_NOTSUPPORTED-et jelöl. |
| DBPROP_INIT_PROVIDERSTRING | Lásd az SQL Server Native Client OLE DB provider stringjét később ebben a témában. |
| DBPROP_INIT_TIMEOUT | Az SQL Server Native Client OLE DB szolgáltató hibát ad az inicializációnál, ha a megadott másodpercek számán belül nem lehet kapcsolatot létrehozni az SQL Server példányához. |
A szolgáltató-specifikus tulajdonsághalmazban DBPROPSET_SQLSERVERDBINIT a SQL Server Native Client OLE DB szolgáltató határozza meg ezeket a további inicializációs tulajdonságokat.
| Tulajdonságazonosító | Description |
|---|---|
| SSPROP_AUTH_OLD_PASSWORD | Típus: VT_BSTR R/W: Írj Alapértelmezés: VT_EMPTY Leírás: A jelenlegi vagy lejárt jelszó. További információért lásd: Programozott jelszóváltás. |
| SSPROP_INIT_APPNAME | Típus: VT_BSTR R/W: Olvasás/írás Leírás: Az ügyfélalkalmazás neve. |
| SSPROP_INIT_AUTOTRANSLATE | Típus: VT_BOOL R/W: Olvasás/írás Alapértelmezés: VARIANT_TRUE Leírás: OEM/ANSI karakterátalakítás. VARIANT_TRUE: Az SQL Server Native Client OLE DB szolgáltató Unicode-on keresztül fordítja le az ANSI karakterláncokat, amelyeket az ügyfél és a szerver között küldenek, hogy minimalizálja a kiterjesztett karakterek összeillesztésének problémáit a kliens és a szerver kódoldalai között: A kliens DBTYPE_STR adatot, amelyet egy SQL Server char, varchar vagy szövegváltozó, paraméter vagy oszlop példányához küldenek, karakterből Unicode-ra konvertálják az ügyfél ANSI kódlapján (ACP), majd Unicode-ból karakterré konvertálják a szerver ACP-jével. Az SQL Server karakter, varcharvagy szöveges adatok, amelyeket egy klienshez DBTYPE_STR változóhoz küldenek, karakterből Unicode-ra konvertálják az ACP szerver segítségével, majd Unicode-ból karakterre az ACP kliensrel. Ezeket a konverziókat az ügyfélen az SQL Server Native Client OLE DB szolgáltató végzi. Ez megköveteli, hogy ugyanaz az ACP, amelyet a szerveren használnak, elérhető legyen az ügyfél számára. Ezek a beállítások nem befolyásolják az áthelyezések során zajló konverziókat: Unicode DBTYPE_WSTR kliensadatok, amelyeket a szerveren szereplő, varchar vagy szöveg felé küldenek. char, varchar vagy text server adatai egy Unicode DBTYPE_WSTR változóhoz küldenek a kliensen. Az ANSI DBTYPE_STR kliensadatok, amelyeket a szerveren Unicode nchar, nvarchar vagy ntext formátumba küldenek. Unicode char, varchar vagy szövegszerver adatai egy ANSI DBTYPE_STR változóhoz küldenek az ügyfélen. VARIANT_FALSE: A SQL Server Native Client OLE DB szolgáltató nem végez karakterfordításokat. A SQL Server Native Client OLE DB szolgáltató nem fordítja le az ügyfél ANSI karaktereket DBTYPE_STR adatokat, amelyeket a szerveren szereplők, varchar vagy szövegváltozók, paraméterek vagy oszlopok felé küldenek. A szerverről a kliensben lévő DBTYPE_STR változókhoz küldött karakter-, varchar- vagy szöveges adatokon nem végeznek fordítást. Ha az ügyfél és az SQL Server példánya eltérő ACP-ket használ, a kiterjesztett karakterek félreértelmezhetők. |
| SSPROP_INIT_CURRENTLANGUAGE | Típus: VT_BSTR R/W: Olvasás/írás Leírás: SQL Server nyelv neve. Azonosítja a rendszerüzenet kiválasztásához és formázásához használt nyelvet. A nyelvet telepíteni kell arra a számítógépre, amely SQL Server példányt futtat, különben az adatforrás inicializálása meghibásodik. |
| SSPROP_INIT_DATATYPECOMPATIBILITY | Típus: VT_UI2 R/W: Olvasás/írás Alapértelmezett: 0 Leírás: Lehetővé teszi az adattípus kompatibilitást az SQL Server és az ActiveX Data Object (ADO) alkalmazások között. Ha az alapértelmezett 0 értéket használják, az adattípus-kezelés alapértelmezettként a szolgáltató által alkalmazott értékre épül. Ha a 80-as értéket használják, az adattípus-kezelés csak SQL Server 2000 (8.x) adattípusokat használ. További információért lásd: ADO használata SQL Server Native Client-szel. |
| SSPROP_INIT_ENCRYPT | Típus: VT_BOOL R/W: Olvasni/Írni Alapértelmezés: VARIANT_FALSE Leírás: A hálózaton keresztül haladó adatok titkosításához SSPROP_INIT_ENCRYPT tulajdonság VARIANT_TRUE-re van állítva. Ha az Enable Protocol Encryption be van kapcsolva, a titkosítás mindig megtörténik, függetlenül a SSPROP_INIT_ENCRYPT beállításától. Ha ki van kapcsolva, és SSPROP_INIT_ENCRYPT VARIANT_TRUE-re van állítva, akkor titkosítás történik. Ha az Enable Protocol Encryption ki van kapcsolva, és SSPROP_INIT_ENCRYPT VARIANT_FALSE-re van állítva, akkor nem történik titkosítás. |
| SSPROP_INIT_FAILOVERPARTNER | Típus: VT_BSTR R/W: Olvasás/írás Leírás: Megadja a rendszeráttételi partner nevét az adatbázis tükrözéséhez. Ez egy inicializációs tulajdonság, és csak az inicializáció előtt állítható. Az inicializáció után visszaadja a rendszerátvételi partnert, ha van, akit az elsődleges szerver adott vissza. Ez lehetővé teszi, hogy egy okos alkalmazás gyorsítótárba helyezze a legutóbb meghatározott biztonsági mentési szervert, de ezeknek az alkalmazásoknak tudniuk kell, hogy az információk csak akkor frissülnek, amikor a kapcsolat először létrejött (vagy újraindítják, ha csoportosítják), és hosszú távú kapcsolatok esetén elavulhatnak. A kapcsolat létrejötte után az alkalmazás lekérdezheti ezt az attribútumot, hogy megállapítsa a failover partner identitását. Ha az elsődleges szervernek nincs failover partnere, ez a tulajdonság üres stringet ad vissza. További információért lásd: Adatbázis-tükrözés használata. |
| SSPROP_INIT_FILENAME | Típus: VT_BSTR R/W: Olvasás/írás Leírás: Megadja egy csatolható adatbázis elsődleges fájlnevét. Ez az adatbázis csatlakozik, és az alapértelmezett adatbázissá válik a kapcsolathoz. A SSPROP_INIT_FILENAME használatához meg kell adnod az adatbázis nevét az inicializációs tulajdonság értékeként DBPROP_INIT_CATALOG. Ha az adatbázis neve nem létezik, akkor keresi a SSPROP_INIT_FILENAME-ben megadott elsődleges fájlnevet, és csatolja azt az DBPROP_INIT_CATALOG-ben megadott nevekhez. Ha az adatbázis korábban csatlakoztatva volt, az SQL Server nem csatolja újra. |
| SSPROP_INIT_MARSCONNECTION | Típus: VT_BOOL R/W: Olvasás/írás Alapértelmezés: VARIANT_FALSE Leírás: Megadja, hogy engedélyezve van-e a Több Aktív Eredményhalmaz (MARS) a kapcsolathoz. Ezt az opciót true-ra kell állítani, mielőtt kapcsolatot hoznának létre az adatbázissal. További információért lásd: Több aktív eredményhalmaz (MARS). |
| SSPROP_INIT_NETWORKADDRESS | Típus: VT_BSTR R/W: Olvasás/írás Leírás: Az SQL Server példányát futtató szerver hálózati címe, amelyet a DBPROP_INIT_DATASOURCE tulajdonság határoz meg. |
| SSPROP_INIT_NETWORKLIBRARY | Típus: VT_BSTR R/W: Olvasás/írás Leírás: A hálózati könyvtár (DLL) neve, amelyet SQL Server példányával való kommunikációhoz használtak. A név nem tartalmazhatja az útvonalat vagy a .dll fájlnév kiterjesztést. Az alapértelmezett testreszabható az SQL Server Client Configuration Utility segítségével. Megjegyzés: Ez a tulajdonság csak a TCP és a Named Pipes támogatást nyújt. Ha ezt a tulajdonságot előtaggal használod, dupla előtagot kapsz, ami hibát okoz, mert a tulajdonság belső előtag generálására szolgál. |
| SSPROP_INIT_PACKETSIZE | Típus: VT_I4 R/W: Olvasás/írás Leírás: Hálózati csomagméret bájtokban. A csomagméret tulajdonságértékének 512 és 32 767 között kell lennie. Az alapértelmezett SQL Server Native Client OLE DB szolgáltató hálózati csomagméret 4 096. |
| SSPROP_INIT_TAGCOLUMNCOLLATION | Típus: BOOL R/W: Írj Alapértelmezés: HAMIS Leírás: Adatbázis frissítése során használatos, amikor szerveroldali kurzorokat használnak. Ez a tulajdonság az adatokat a szerverről származó összeállítási információval jelöli, nem pedig a kliens kódoldalán. Jelenleg ezt a tulajdonságot csak az elosztott lekérdezési folyamat használja, mert ismeri a céladatok összeállítását, és helyesen konvertálja azokat. |
| SSPROP_INIT_TRUST_SERVER_CERTIFICATE | Típus: VT_BOOL R/W: Olvasás/írás Alapértelmezés: VARIANT_FALSE Leírás: Szerver tanúsítvány ellenőrzésének engedélyezésére vagy letiltására szolgál. Ez a tulajdonság olvasás/írás módjára működik, de ha a kapcsolat létrejötte után próbáljuk beállítani, hibát okoz. Ezt a tulajdonságot figyelmen kívül hagyják, ha az ügyfél úgy van konfigurálva, hogy tanúsítvány validációt igényeljen. Azonban egy alkalmazás használhatja ezt SSPROP_INIT_ENCRYPT-vel együtt, hogy garantálja, hogy a szerverhez való kapcsolata titkosított legyen, még akkor is, ha az ügyfél úgy van konfigurálva, hogy nem igényel titkosítást, és nincs tanúsítvány a kliensben. Az ügyfélalkalmazások a kapcsolat megnyitása után is lekérdezhetik ezt a tulajdonságot, hogy meghatározzák a tényleges titkosítási és érvényesítési beállításokat. Megjegyzés: Titkosítás használata tanúsítvány ellenőrzés nélkül részleges védelmet nyújt a csomag szimatolása ellen, de nem véd a középen lévő ember-támadások ellen. Egyszerűen lehetővé teszi a bejelentkezés és a szerverre küldött adatok titkosítását anélkül, hogy a szerver tanúsítványt ellenőriznék. További információért lásd: Titkosítás használata érvényesítés nélkül. |
| SSPROP_INIT_USEPROCFORPREP | Típus: VT_I4 R/W: Olvasás/írás Alapértelmezés: SSPROPVAL_USEPROCFORPREP_ON Leírás: Az SQL Server tárolt eljárás használata. Definiálja az SQL Server ideiglenes tárolt eljárásainak használatát az ICommandPrepare felület támogatására. Ez a tulajdonság csak akkor volt értelmes, amikor SQL Server 6.5-höz csatlakozott. A tulajdonságot későbbi verzióknál figyelmen kívül hagyják. SSPROPVAL_USEPROCFORPREP_OFF: Ideiglenes tárolt eljárás nem jön létre, amikor parancsot készítenek. SSPROPVAL_USEPROCFORPREP_ON: Ideiglenes tárolt eljárás jön létre, amikor egy parancsot készítenek. Az ideiglenes tárolt eljárásokat a session kiszabadulása után elhagyják. SSPROPVAL_USEPROCFORPREP_ON_DROP: Ideiglenes tárolt eljárás jön létre, amikor parancsot készítenek. Az eljárás akkor kerül el, ha a parancs nincs előkészítve ICommandPrepare::Unprepare-ben, amikor új parancsot jelölnek meg a parancsobjektumra ICommandText::SetCommandText segítségével, vagy amikor minden alkalmazáshivatkozás a parancsra kiszabadul. |
| SSPROP_INIT_WSID | Típus: VT_BSTR R/W: Olvasás/írás Leírás: Egy munkaállomást azonosító lánc. |
A szolgáltató-specifikus tulajdonsághalmazban DBPROPSET_SQLSERVERDATASOURCEINFO a SQL Server Native Client OLE DB szolgáltató határozza meg az extra tulajdonságokat; további információért lásd az Adatforrás-információs tulajdonságokat.
Az SQL Server natív kliens OLE DB szolgáltató stringje
Az SQL Server Native Client OLE DB szolgáltató felismer egy ODBC-szerű szintaxist a szolgáltató string tulajdonságaiban. A szolgáltató string tulajdonsága az OLE DB inicializációs tulajdonságának értékeként jelenik meg, DBPROP_INIT_PROVIDERSTRING amikor kapcsolatot hoznak létre az OLE DB adatforráshoz. Ez a tulajdonság megadja az OLE DB szolgáltató-specifikus kapcsolati adatokat, amelyek szükségesek az OLE DB adatforráshoz való csatlakozás megvalósításához. A láncszálon belül az elemeket féleskolóval választják meg. A sorozat utolsó elemét egy szemespillült kell befejezni. Minden elem egy kulcsszóból, egy egyenlőségjelből és az inicializáció során átadott értékből áll. Például:
Server=MyServer;UID=MyUserName;
Az SQL Server Native Client OLE DB szolgáltatóval a fogyasztónak soha nem kell használnia a szolgáltató string tulajdonságot. A felhasználó beállíthatja a szolgáltató stringben tükröződő inicializációs tulajdonságot OLE DB vagy az SQL Server Native Client OLE DB szolgáltató-specifikus inicializációs tulajdonságok használatával.
Az SQL Server Native Client OLE DB szolgáltatóban elérhető kulcsszavak listájáért lásd: Connection String Keywords using with SQL Server Native Client.