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.
Vonatkozik a következőkre:
SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalitikai Platform System (PDW)SQL adatbázis a Microsoft Fabric-ben
Az SQL Server OLE DB-illesztőjében egyes API-k kapcsolati sztringeket használnak a kapcsolati attribútumok megadásához. A kapcsolati sztringek a kulcsszó és a kapcsolódó értékek listája; minden kulcsszó egy adott kapcsolatattribútumot azonosít.
Megjegyzés:
Az SQL Serverhez készült OLE DB-illesztő lehetővé teszi a kapcsolati sztringek kétértelműségét a visszamenőleges kompatibilitás fenntartása érdekében (például előfordulhat, hogy egyes kulcsszavakat többször is meg lehet adni, és az ütköző kulcsszavak hely vagy elsőbbség alapján feloldhatók). Az SQL Server OLE DB Driver jövőbeli kiadásai nem feltétlenül engedik a kapcsolati láncok kétértelműségét. Az alkalmazások módosításakor célszerű az OLE DB-illesztőt használni az SQL Serverhez a kapcsolati sztringekben rejlő kétértelműség kiküszöbölésére.
Az alábbi szakaszok az SQL Server OLE DB-illesztőprogramjával és az ActiveX-adatobjektumokkal (ADO) használható kulcsszavakat ismertetik az SQL Serverhez készült OLE DB-illesztőprogram adatszolgáltatóként való használatakor.
OLE DB-illesztő kapcsolati sztringszavai
Az OLE DB-alkalmazások kétféleképpen inicializálhatják az adatforrás-objektumokat:
IDBInitialize::Initialize
IDataInitialize::GetDataSource
Az első esetben egy szolgáltatói sztring használható a kapcsolat tulajdonságainak inicializálására a DBPROPSET_DBINIT tulajdonságkészletben DBPROP_INIT_PROVIDERSTRING tulajdonság beállításával. A második esetben egy inicializálási sztring továbbítható az IDataInitialize::GetDataSource metódusnak a kapcsolat tulajdonságainak inicializálásához. Mindkét módszer ugyanazokat az OLE DB-kapcsolattulajdonságokat inicializálja, de a rendszer különböző kulcsszavakat használ. Az IDataInitialize::GetDataSource által használt kulcsszavak legalább az inicializálási tulajdonságcsoporton belüli tulajdonságok leírása.
Minden olyan szolgáltatói sztringbeállítás, amelynek megfelelő OLE DB-tulajdonsága valamilyen alapértelmezett értékre van beállítva, vagy explicit módon értékre van állítva, az OLE DB tulajdonság értéke felülbírálja a szolgáltatói sztringben lévő beállítást.
A szolgáltatói sztringekben megadott boolean tulajdonságok az értékek yes és no szerint vannak beállítva DBPROP_INIT_PROVIDERSTRING értékekkel. Az IDataInitialize::GetDataSource használatával az inicializálási sztringekben beállított logikai tulajdonságok a true és false értékekkel vannak beállítva.
Az IDataInitialize::GetDataSource-t használó alkalmazások az IDBInitialize::Initialize által használt kulcsszavakat is használhatják, de csak az alapértelmezett értékkel nem rendelkező tulajdonságokhoz. Ha egy alkalmazás az IDataInitialize::GetDataSource kulcsszót és az IDBInitialize::Initialize kulcsszót is használja az inicializálási sztringben, az IDataInitialize::GetDataSource kulcsszóbeállítást használja. Javasoljuk, hogy az alkalmazások ne használják az IDBInitialize::Initialize kulcsszavakat az IDataInitialize:GetDataSource kapcsolatisztringekben, mivel ez a viselkedés a jövőbeni kiadásokban esetleg nem tartható fenn.
Megjegyzés:
Az IDataInitialize::GetDataSource-on keresztül átadott kapcsolati string tulajdonsággá alakul és IDBProperties::SetProperties segítségével alkalmazzák. Ha az összetevő-szolgáltatások az IDBProperties::GetPropertyInfo tulajdonságleírást találták, a tulajdonság önálló tulajdonságként lesz alkalmazva. Ellenkező esetben a rendszer DBPROP_PROVIDERSTRING tulajdonságon keresztül alkalmazza. Ha például a Data Source=server1 kapcsolati sztringet adja meg; Server=server2, Az adatforrás tulajdonságként lesz beállítva, de a kiszolgáló egy szolgáltatói sztringbe kerül.
Ha ugyanazon szolgáltatóspecifikus tulajdonság több példányát adja meg, a rendszer az első tulajdonság első értékét fogja használni.
Az IDBInitialize használata::Initialize
Az OLE DB-alkalmazások által az IDBInitialize használatával DBPROP_INIT_PROVIDERSTRING használt kapcsolati sztringek::Az inicializálás szintaxisa a következő:
connection-string ::= empty-string[;] | attribute[;] | attribute; connection-stringempty-string ::=attribute ::= attribute-keyword=[{]attribute-value[}]attribute-value ::= character-stringattribute-keyword ::= identifier
Az attribútumértékek opcionálisan zárójelek közé is csatolhatók, és ezt célszerű megtenni. Ez a gyakorlat elkerüli a problémákat, ha az attribútumértékek nem alfanumerikus karaktereket tartalmaznak. Az érték első záró zárójele azt feltételezi, hogy leállítja az értéket, így az értékek nem tartalmazhatnak záró zárójelkaraktereket.
A kapcsolati sztring kulcsszava után álló = szóköz karakter még akkor is literálként értelmeződik, ha az érték idézőjelben van.
Az alábbi táblázat a DBPROP_INIT_PROVIDERSTRING használható kulcsszavakat ismerteti.
| Keyword | Inicializálási tulajdonság | Description |
|---|---|---|
| Bővítő | SSPROP_INIT_NETWORKADDRESS | A Cím szinonimája. |
| Cím | SSPROP_INIT_NETWORKADDRESS | Az SQL Server egy példányát futtató kiszolgáló hálózati címe.
A cím általában a kiszolgáló hálózati neve, de lehetnek más elnevezések is, például csővezeték, IP-cím vagy TCP/IP-port és csatlakozási cím. Ha IP-címet ad meg, győződjön meg arról, hogy a TCP/IP vagy a nevesített csövek protokollja engedélyezve van az SQL Server Configuration Managerben. A Cím érték elsőbbséget élvez a kiszolgálónak a kapcsolati sztringekben átadott értékkel szemben, amikor az OLE DB-illesztőprogramot használja az SQL Serverhez. Azt is vegye figyelembe, hogy Address=; a kiszolgáló kulcsszóban megadott kiszolgálóhoz csatlakozik, míg Address= ;, Address=.;a , Address=localhost;és Address=(local); mindegyik kapcsolatot okoz a helyi kiszolgálóval.A Cím kulcsszó teljes szintaxisa a következő: [protokoll:]Cím[,port |\pipe\pipename] protokoll lehet tcp (TCP/IP), lpc (megosztott memória) vagy np (elnevezett csövek). További információ a protokollokról: Ügyfélprotokollok konfigurálása. Ha sem a protokoll , sem a hálózati kulcsszó nincs megadva, az SQL Server OLE DB-illesztőprogramja az SQL Server Configuration Managerben megadott protokoll-sorrendet fogja használni. port az a port, amelyhez csatlakozni szeretne a megadott kiszolgálón. Az SQL Server alapértelmezés szerint az 1433-at használja. |
| APP | SSPROP_INIT_APPNAME | Az alkalmazást azonosító sztring. |
| ApplicationIntent | SSPROP_INIT_APPLICATIONINTENT | Deklarálja az alkalmazás számítási feladatainak típusát a kiszolgálóhoz való csatlakozáskor. A lehetséges értékek a következők: ReadOnly és ReadWrite.Az alapértelmezett érték a ReadWrite. További információ az SQL Server Always On rendelkezésre állási csoportokhoz nyújtott OLE DB-illesztőprogramjáról: OLE DB Driver for SQL Server Support for High Availability, Disaster Recovery. |
| AttachDBFileName | SSPROP_INIT_FILENAME | Egy csatolható adatbázis elsődleges fájljának neve (a teljes elérési utat is tartalmazza). Az AttachDBFileName használatához meg kell adnia az adatbázis nevét is a szolgáltatói sztring 'Database' kulcsszavával. Ha az adatbázist korábban csatolták, az SQL Server nem csatlakoztatja újra (a csatolt adatbázist használja alapértelmezettként a kapcsolathoz). |
| Hitelesítés 1 | SSPROP_AUTH_MODE | A használt SQL- vagy Microsoft Entra-hitelesítést adja meg. Az érvényes értékek a következők:
JEGYZET: A ActiveDirectoryIntegrated kulcsszó windowsos hitelesítéshez is használható az SQL Serverhez. Lecseréli a Integrated Security (vagy Trusted_Connection) hitelesítési kulcsszavakat. Javasoljuk, hogy a Integrated Security(vagy Trusted_Connection) kulcsszavakat vagy azok megfelelő tulajdonságait használó alkalmazások a Authentication kulcsszó (vagy annak megfelelő tulajdonsága) értékét állítsák be ActiveDirectoryIntegrated az új titkosítási és tanúsítványérvényesítési viselkedés engedélyezéséhez.JEGYZET: Javasoljuk, hogy a hitelesítést használó SQL Server alkalmazások a kulcsszó (vagy annak megfelelő tulajdonsága) értékét állítsa be az AuthenticationSqlPassword engedélyezéséhez. |
| Automatikus fordítás | SSPROP_INIT_AUTOTRANSLATE | Az automatikus fordítás szinonimája. |
| Automatikus fordítás | SSPROP_INIT_AUTOTRANSLATE | Az OEM/ANSI karakterfordítást konfigurálja. A felismert értékek a yes és a no vannak. |
| ConnectRetryCount | SSPROP_INIT_CONNECT_RETRY_COUNT | A kapcsolat megszakadása esetén az újracsatlakozási kísérletek számát szabályozza. Az érvényes értékek a 0 és 255 között terjednek. Az alapértelmezett érték a 1. A 0 érték nem kísérelné meg újracsatlakozni. További információ: Tétlen kapcsolat ellenálló képessége. |
| ConnectRetryInterval | SSPROP_INIT_CONNECT_RETRY_INTERVAL | A kapcsolat megszakadása esetén az egyes újrapróbálkozási kísérletek között eltelt másodpercek számát adja meg. Az érvényes értékek a 1 és 60 között terjednek. Az alapértelmezett érték a 10. További információ: Tétlen kapcsolat ellenálló képessége. |
| Adatbázis | DBPROP_INIT_CATALOG | Az adatbázis neve. |
| DataTypeCompatibility | SSPROP_INIT_DATATYPECOMPATIBILITY | Megadja a használni kívánt adattípus-kezelés módját. A felismert értékek a 0 szolgáltatói adattípusokhoz és 80 az SQL Server 2000 adattípusokhoz tartoznak. |
| Titkosítás1 | SSPROP_INIT_ENCRYPT | Megadja, hogy az adatok titkosítva legyenek-e a hálózaton keresztüli küldés előtt. A lehetséges értékek a következők: Optional, Mandatoryés Strict. Az alapértelmezett érték a Mandatory. A 18.x.x verziókkal kapcsolatban lásd az MSOLEDBSQL főverzió-eltéréseit. |
| Kiesésvédelmi partner | SSPROP_INIT_FAILOVERPARTNER | Az adatbázis-tükrözéshez használt átvételi kiszolgáló neve. |
| FeladatátvételpartnerSPN | SSPROP_INIT_FAILOVERPARTNERSPN | A feladatátvevő partner SPN-je. Az alapértelmezett érték egy üres sztring. Egy üres sztring miatt az SQL Serverhez készült OLE DB-illesztő az alapértelmezett, szolgáltató által generált SPN-t használja. |
| HostNameInCertificate | SSPROP_INIT_HOST_NAME_CERTIFICATE | Az SQL Server TLS/SSL-tanúsítvány érvényesítéséhez használandó állomásnév. Ha a HostNameInCertificate kulcsszó nincs beállítva, az illesztő a kiszolgáló kulcsszóértékét használja a kapcsolati URL-címen állomásnévként az SQL Server TLS/SSL-tanúsítvány érvényesítéséhez. JEGYZET: A rendszer figyelmen kívül hagyja ezt a tulajdonságot, ha a kiszolgálótanúsítvány megbízható. Ha a titkosítás értéke be van állítva Strict, a tanúsítvány mindig érvényesítve lesz. |
| Nyelv | SSPROP_INIT_CURRENTLANGUAGE | Az SQL Server nyelve. |
| MarsConn | SSPROP_INIT_MARSCONNECTION | Több aktív eredményhalmaz (MARS) engedélyezése vagy letiltása a kapcsolaton, ha a kiszolgáló SQL Server 2005 (9.x) vagy újabb. A lehetséges értékek a következők: yes és no. Az alapértelmezett érték a no. |
| MultiSubnetFailover | SSPROP_INIT_MULTISUBNETFAILOVER | Mindig adja meg a MultiSubnetFailover=Igen értéket, amikor egy SQL Server rendelkezésre állási csoport vagy egy SQL Server feladatátvevőfürt-példány rendelkezésre állási csoportfigyelőjével csatlakozik.
A MultiSubnetFailover=Yes konfigurálja az OLE DB-illesztőt az SQL Serverhez, hogy gyorsabb észlelést és kapcsolatot biztosítson az (jelenleg) aktív kiszolgálóhoz. A lehetséges értékek a következők: Yes és No. Az alapértelmezett érték a No. Például:MultiSubnetFailover=YesTovábbi információ az SQL Server Always On rendelkezésre állási csoportokhoz nyújtott OLE DB-illesztőprogramjáról: OLE DB Driver for SQL Server Support for High Availability, Disaster Recovery. |
| Net | SSPROP_INIT_NETWORKLIBRARY | A hálózat szinonimája. |
| Network | SSPROP_INIT_NETWORKLIBRARY | A szervezet SQL Server-példányával létesített kapcsolat létesítéséhez használt hálózati kódtár. |
| Hálózati kódtár | SSPROP_INIT_NETWORKLIBRARY | A hálózat szinonimája. |
| PacketSize | SSPROP_INIT_PACKETSIZE | Táblázatos adatfolyam (TDS) csomagmérete. Az alapértelmezett érték 0 (a tényleges értéket a kiszolgáló határozza meg). |
| PersistSensitive | DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO | Elfogadja a sztringeket yes és no mint értékeket. Használat esetén no az adatforrás-objektum nem őrizhet meg bizalmas hitelesítési adatokat |
| PWD | DBPROP_AUTH_PASSWORD | Az SQL Server bejelentkezési jelszava. |
| Kiszolgáló | DBPROP_INIT_DATASOURCE | Egy SQL Server-példány neve. Az értéknek tartalmaznia kell a hálózati kiszolgáló nevét, egy IP-címet vagy egy SQL Server Configuration Manager-alias nevét. Ha nincs megadva, a rendszer kapcsolatot létesít a helyi számítógép alapértelmezett példányával. A Cím kulcsszó felülbírálja a kiszolgáló kulcsszót. A helyi kiszolgálón az alapértelmezett példányhoz az alábbi lehetőségek egyikének megadásával csatlakozhat: Server=; Server=.; Server=(helyi); Server=(helyi); Server=(localhost); Server=(localdb)\instancename; További információ a LocalDB támogatásáról: OLE DB Driver for SQL Server Support for LocalDB. Az SQL Server nevesített példányának megadásához fűzze hozzá \ az InstanceName parancsot. Ha nincs megadva kiszolgáló, a rendszer kapcsolatot létesít a helyi számítógép alapértelmezett példányával. Ha IP-címet ad meg, győződjön meg arról, hogy a TCP/IP vagy a nevesített csövek protokollja engedélyezve van az SQL Server Configuration Managerben. A Kiszolgáló kulcsszó teljes szintaxisa a következő: Server=[protokoll:]Kiszolgáló[,port] protokoll lehet tcp (TCP/IP), lpc (megosztott memória) vagy np (elnevezett csövek). Az alábbi példa egy elnevezett csövet határoz meg: np:\\.\pipe\MSSQL$MYINST01\sql\queryA fenti sor megadja a nevesített csőprotokollt ( np), a helyi gépen található elnevezett csövet (\\.\pipe), az SQL Server-példány nevét (MSSQL$MYINST01), valamint az elnevezett cső (sql/query) alapértelmezett nevét.Ha sem protokoll , sem hálózati kulcsszó nincs megadva, az SQL Server OLE DB-illesztőprogramja az SQL Server Configuration Managerben megadott protokoll-sorrendet fogja használni. port az a port, amelyhez csatlakozni szeretne a megadott kiszolgálón. Az SQL Server alapértelmezés szerint az 1433-at használja. A rendszer figyelmen kívül hagyja a szóközöket az érték elején, amelyet a kapcsolati sztringekben a Server-nek adnak át az SQL Server OLE DB-illesztőprogramjának használatakor. |
| ServerCertificate | SSPROP_INIT_SERVER_CERTIFICATE | Megadja az SQL Server TLS/SSL-tanúsítványnak megfelelő tanúsítványfájl elérési útját. Ez a beállítás csak akkor használható, ha Strict a titkosítás engedélyezve van. Az elfogadott tanúsítványformátumok a PEM, a DER és a CER. Ha meg van adva, a rendszer ellenőrzi az SQL Server-tanúsítványt, és ellenőrzi, hogy a megadott tanúsítvány pontosan egyezik-e. |
| ServerSPN | SSPROP_INIT_SERVERSPN | A kiszolgáló SPN-je. Az alapértelmezett érték egy üres sztring. Egy üres sztring miatt az SQL Serverhez készült OLE DB-illesztő az alapértelmezett, szolgáltató által generált SPN-t használja. |
| Időkorlát | DBPROP_INIT_TIMEOUT | Az adatforrás inicializálásának befejezésére váró idő (másodpercben). |
| TransparentNetworkIPResolution | SSPROP_INIT_TNIR | Hatással van a kapcsolatsorrendre, ha az első feloldott IP-cím nem válaszol, és az IP címhez több IP van társítva. A TNIR együttműködik a MultiSubnetFailover szolgáltatással, hogy különböző kapcsolatütemezéseket biztosítson. A lehetséges értékek a következők: Yes és No. Az alapértelmezett érték a Yes. További információ: Transzparens hálózati IP-felbontás használata. |
| Trusted_Connection | DBPROP_AUTH_INTEGRATED | Amikor yesez a beállítás arra utasítja az SQL Server OLE DB-illesztőjét, hogy használja a Windows-hitelesítést a bejelentkezés ellenőrzéséhez. Ellenkező esetben az SQL Server OLE DB-illesztője egy SQL Server-felhasználónevet és jelszót használ a bejelentkezés ellenőrzéséhez, és meg kell adni a UID és a PWD kulcsszavakat. |
| TrustServerCertificate1 | SSPROP_INIT_TRUST_SERVER_CERTIFICATE | Elfogadja a sztringeket yes és no mint értékeket. Az alapértelmezett érték az no, ami azt jelenti, hogy a kiszolgálótanúsítvány érvényesítve lesz. |
| UID | DBPROP_AUTH_USERID | Az SQL Server bejelentkezési neve. |
| UseFMTONLY | SSPROP_INIT_USEFMTONLY | A metaadatok lekérésének módját szabályozza az SQL Server 2012 -hez (11.x) és újabbhoz való csatlakozáskor. A lehetséges értékek a következők: yes és no. Az alapértelmezett érték a no.Az SQL Server OLE DB-illesztőprogramja alapértelmezés szerint sp_describe_first_result_set és sp_describe_undeclared_parameters tárolt eljárásokat használ a metaadatok lekéréséhez. Ezek a tárolt eljárások bizonyos korlátozásokkal rendelkeznek (például az ideiglenes táblákon való működés során sikertelenek lesznek). A UseFMTONLY yes beállítása arra utasítja az illesztőprogramot, hogy ehelyett a SET FMTONLY függvényt használja a metaadatok lekéréséhez. |
| UseProcForPrepare | SSPROP_INIT_USEPROCFORPREP | Ez a kulcsszó elavult, és a beállítását az SQL Server OLE DB-illesztőprogramja figyelmen kívül hagyja. |
| WSID | SSPROP_INIT_WSID | A munkaállomás azonosítója. |
[1]: A biztonság javítása érdekében a titkosítás és a tanúsítványérvényesítés viselkedése módosul a hitelesítési vagy hozzáférési jogkivonat inicializálási tulajdonságai vagy a hozzájuk tartozó kapcsolati sztring-kulcsszavak használatakor. További információ: Titkosítás és tanúsítványérvényesítés.
Az IDataInitialize használata::GetDataSource
Az OLE DB-alkalmazások által az IDataInitialize::GetDataSource használatával használt kapcsolati sztringek a következő szintaxissal rendelkeznek:
connection-string ::= empty-string[;] | attribute[;] | attribute; connection-stringempty-string ::=attribute ::= attribute-keyword=[quote]attribute-value[quote]attribute-value ::= character-stringattribute-keyword ::= identifierquote ::= " | '
A tulajdonság használatának meg kell felelnie a hatókörében engedélyezett szintaxisnak. A WSID például kapcsos zárójeleket ({}) idézőjeleket, az alkalmazásnév pedig egyetlen (') vagy dupla (") idézőjelet használ. Csak sztring tulajdonságok idézhetők. Ha egy egész vagy enumerált tulajdonságot próbál idézni, az hibát fog eredményezni Connection String doesn't conform to OLE DB specification .
Az attribútumértékek opcionálisan egy- vagy két idézőjelbe is csatolhatók, és ezt célszerű megtenni. Ez a gyakorlat elkerüli a problémákat, ha az értékek nem alfanumerikus karaktereket tartalmaznak. A használt idézett karakter az értékekben is megjelenhet, ha azokat dupla idézőjelek közé zárják.
A kapcsolati sztring kulcsszavának egyenlőségjele utáni szóközkarakter akkor is literálként értelmeződik, ha az érték idézőjelek közé van foglalva.
Ha egy kapcsolati sztring több tulajdonsággal is rendelkezik az alábbi táblázatban felsorolt tulajdonságok közül, a rendszer az utolsó tulajdonság értékét használja.
Az alábbi táblázat az IDataInitialize::GetDataSource használatával használható kulcsszavakat ismerteti:
| Keyword | Inicializálási tulajdonság | Description |
|---|---|---|
| Hozzáférési jogkivonat1 | SSPROP_AUTH_ACCESS_TOKEN | A Microsoft Entra-azonosító hitelesítéséhez használt hozzáférési jogkivonat. JEGYZET: Hiba, ha megadjuk ezt a kulcsszót, és a UIDPWD, Trusted_Connection, vagy Authentication kapcsolati sztring kulcsszavait vagy azok tulajdonságait/kulcsszavait. |
| Alkalmazás neve | SSPROP_INIT_APPNAME | Az alkalmazást azonosító sztring. |
| Alkalmazás szándéka | SSPROP_INIT_APPLICATIONINTENT | Deklarálja az alkalmazás számítási feladatainak típusát a kiszolgálóhoz való csatlakozáskor. A lehetséges értékek a következők: ReadOnly és ReadWrite.Az alapértelmezett érték a ReadWrite. További információ az SQL Server Always On rendelkezésre állási csoportokhoz nyújtott OLE DB-illesztőprogramjáról: OLE DB Driver for SQL Server Support for High Availability, Disaster Recovery. |
| Hitelesítés 1 | SSPROP_AUTH_MODE | A használt SQL- vagy Microsoft Entra-hitelesítést adja meg. Az érvényes értékek a következők:
JEGYZET: A ActiveDirectoryIntegrated kulcsszó windowsos hitelesítéshez is használható az SQL Serverhez. Lecseréli a Integrated Security (vagy Trusted_Connection) hitelesítési kulcsszavakat. Javasoljuk, hogy a Integrated Security(vagy Trusted_Connection) kulcsszavakat vagy azok megfelelő tulajdonságait használó alkalmazások a Authentication kulcsszó (vagy annak megfelelő tulajdonsága) értékét állítsák be ActiveDirectoryIntegrated az új titkosítási és tanúsítványérvényesítési viselkedés engedélyezéséhez.JEGYZET: Javasoljuk, hogy a hitelesítést használó SQL Server alkalmazások a kulcsszó (vagy annak megfelelő tulajdonsága) értékét állítsa be az AuthenticationSqlPassword engedélyezéséhez. |
| Automatikus fordítás | SSPROP_INIT_AUTOTRANSLATE | Az OEM/ANSI karakterfordítást konfigurálja. A felismert értékek a true és a false vannak. |
| Csatlakozás időtúllépése | DBPROP_INIT_TIMEOUT | Az adatforrás inicializálásának befejezésére váró idő (másodpercben). |
| Újrapróbálkozás száma csatlakoztatása | SSPROP_INIT_CONNECT_RETRY_COUNT | A kapcsolat megszakadása esetén az újracsatlakozási kísérletek számát szabályozza. Az érvényes értékek a 0 és 255 között terjednek. Az alapértelmezett érték a 1. A 0 érték nem kísérelné meg újracsatlakozni. További információ: Tétlen kapcsolat ellenálló képessége. |
| Újrapróbálkozási időköz | SSPROP_INIT_CONNECT_RETRY_INTERVAL | A kapcsolat megszakadása esetén az egyes újrapróbálkozási kísérletek között eltelt másodpercek számát adja meg. Az érvényes értékek a 1 és 60 között terjednek. Az alapértelmezett érték a 10. További információ: Tétlen kapcsolat ellenálló képessége. |
| Aktuális nyelv | SSPROPT_INIT_CURRENTLANGUAGE | Az SQL Server nyelvének neve. |
| Adatforrás | DBPROP_INIT_DATASOURCE | Az SQL Server egy példányának neve a szervezetben. Ha nincs megadva, a rendszer kapcsolatot létesít a helyi számítógép alapértelmezett példányával. Az érvényes címszintaxissal kapcsolatos további információkért tekintse meg a kiszolgáló kulcsszójának leírását ebben a cikkben. |
| DataTypeCompatibility | SSPROP_INIT_DATATYPECOMPATIBILITY | Megadja a használni kívánt adattípus-kezelés módját. A felismert értékek 0 a szolgáltatói adattípusokhoz és 80 az SQL Server 2000 (8.x) adattípusokhoz tartoznak. |
| Feladatátvételi partner | SSPROP_INIT_FAILOVERPARTNER | Az adatbázis-tükrözéshez használt átvételi kiszolgáló neve. |
| Átállási partner SPN | SSPROP_INIT_FAILOVERPARTNERSPN | A feladatátvevő partner SPN-je. Az alapértelmezett érték egy üres sztring. Egy üres sztring miatt az SQL Serverhez készült OLE DB-illesztő az alapértelmezett, szolgáltató által generált SPN-t használja. |
| Hostnév a tanúsítványban | SSPROP_INIT_HOST_NAME_CERTIFICATE | Az SQL Server TLS/SSL-tanúsítvány érvényesítéséhez használandó állomásnév. Ha a tanúsítvány gazdagépneve kulcsszó nincs beállítva, a meghajtó a kapcsolat URL-jében szereplő Adatforrás kulcsszó értékét használja állomásnévként az SQL Server TLS/SSL-tanúsítvány érvényesítéséhez. JEGYZET: A rendszer figyelmen kívül hagyja ezt a tulajdonságot, ha a kiszolgálótanúsítvány megbízható. Ha a Use Encryption for Data (Adattitkosítás használata) értékre van állítva Strict, a tanúsítvány mindig érvényesítve lesz. |
| Alapkatalógus | DBPROP_INIT_CATALOG | Az adatbázis neve. |
| Kezdeti fájlnév | SSPROP_INIT_FILENAME | Egy csatolható adatbázis elsődleges fájljának neve (a teljes elérési utat is tartalmazza). Az AttachDBFileName használatához meg kell adnia az adatbázis nevét az ADATBÁZIS kulcsszóval a szolgáltató sztringben. Ha az adatbázist korábban csatolták, az SQL Server nem csatlakoztatja újra (a csatolt adatbázist használja alapértelmezettként a kapcsolathoz). |
| Integrált biztonság | DBPROP_AUTH_INTEGRATED | Elfogadja a Windows-hitelesítés értékét SSPI . |
| MARS-kapcsolat | SSPROP_INIT_MARSCONNECTION | Több aktív eredményhalmaz (MARS) engedélyezése vagy letiltása a kapcsolaton. A felismert értékek a true és a false vannak. Az alapértelmezett érték a false. |
| MultiSubnetFailover | SSPROP_INIT_MULTISUBNETFAILOVER | Mindig adja meg a MultiSubnetFailover=True értéket, amikor egy SQL Server rendelkezésre állási csoport vagy egy SQL Server feladatátvevőfürt-példány rendelkezésre állási csoportfigyelőjével csatlakozik.
A MultiSubnetFailover=True úgy konfigurálja az OLE DB-illesztőt az SQL Serverhez, hogy gyorsabb észlelést és kapcsolatot biztosítson az (jelenleg) aktív kiszolgálóhoz. A lehetséges értékek a következők: True és False. Az alapértelmezett érték a False. Például:MultiSubnetFailover=TrueTovábbi információ az SQL Server Always On rendelkezésre állási csoportokhoz nyújtott OLE DB-illesztőprogramjáról: OLE DB Driver for SQL Server Support for High Availability, Disaster Recovery. |
| Hálózati cím | SSPROP_INIT_NETWORKADDRESS | Az SQL Server egy példányának hálózati címe a szervezetben. Az érvényes címszintaxissal kapcsolatos további információkért tekintse meg a Cím kulcsszó leírását ebben a cikkben. |
| Hálózati kódtár | SSPROP_INIT_NETWORKLIBRARY | A szervezet SQL Server-példányával létesített kapcsolat létesítéséhez használt hálózati kódtár. |
| Csomagméret | SSPROP_INIT_PACKETSIZE | Táblázatos adatfolyam (TDS) csomagmérete. Az alapértelmezett érték 0 (a tényleges értéket a kiszolgáló határozza meg). |
| Jelszó | DBPROP_AUTH_PASSWORD | Az SQL Server bejelentkezési jelszava. |
| Biztonsági adatok megőrzése | DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO | A karakterláncokat true és false értékként fogadja el. Amikor falseaz adatforrás-objektum nem őrizhet meg bizalmas hitelesítési adatokat |
| Szolgáltató | Az SQL Server OLE DB-illesztője esetében ennek az értéknek "MSOLEDBSQL19" vagy "MSOLEDBSQL" értékűnek kell lennie. | |
| Kiszolgálói tanúsítvány | SSPROP_INIT_SERVER_CERTIFICATE | Megadja az SQL Server TLS/SSL-tanúsítványnak megfelelő tanúsítványfájl elérési útját. Ez a beállítás csak akkor használható, ha Strict a titkosítás engedélyezve van. Az elfogadott tanúsítványformátumok a PEM, a DER és a CER. Ha meg van adva, a rendszer ellenőrzi az SQL Server-tanúsítványt, és ellenőrzi, hogy a megadott tanúsítvány pontosan egyezik-e. |
| Kiszolgálói SPN | SSPROP_INIT_SERVERSPN | A kiszolgáló SPN-je. Az alapértelmezett érték egy üres sztring. Egy üres sztring miatt az SQL Serverhez készült OLE DB-illesztő az alapértelmezett, szolgáltató által generált SPN-t használja. |
| TransparentNetworkIPResolution | SSPROP_INIT_TNIR | Hatással van a kapcsolatsorrendre, ha az első feloldott IP-cím nem válaszol, és az IP címhez több IP van társítva. A TNIR együttműködik a MultiSubnetFailover szolgáltatással, hogy különböző kapcsolatütemezéseket biztosítson. A lehetséges értékek a következők: True és False. Az alapértelmezett érték a True. További információ: Transzparens hálózati IP-felbontás használata. |
| Kiszolgáló megbízhatósági tanúsítvány1 | SSPROP_INIT_TRUST_SERVER_CERTIFICATE | Elfogadja a sztringeket true és false mint értékeket. Az alapértelmezett érték az false, ami azt jelenti, hogy a kiszolgálótanúsítvány érvényesítve lesz. |
| Adatok titkosítása1 | SSPROP_INIT_ENCRYPT | Megadja, hogy az adatok titkosítva legyenek-e a hálózaton keresztüli küldés előtt. A lehetséges értékek a következők: Optional, Mandatoryés Strict. Az alapértelmezett érték a Mandatory. A 18.x.x verziókkal kapcsolatban lásd az MSOLEDBSQL főverzió-eltéréseit. |
| FMTONLY használata | SSPROP_INIT_USEFMTONLY | A metaadatok lekérésének módját szabályozza az SQL Server 2012 -hez (11.x) és újabbhoz való csatlakozáskor. A lehetséges értékek a következők: true és false. Az alapértelmezett érték a false.Az SQL Server OLE DB-illesztőprogramja alapértelmezés szerint sp_describe_first_result_set és sp_describe_undeclared_parameters tárolt eljárásokat használ a metaadatok lekéréséhez. Ezek a tárolt eljárások bizonyos korlátozásokkal rendelkeznek (például az ideiglenes táblákon való működés során sikertelenek lesznek). A beállítás az FMTONLY true használatával arra utasítja az illesztőprogramot, hogy ehelyett a SET FMTONLY függvényt használja a metaadatok lekéréséhez. |
| Felhasználóazonosító | DBPROP_AUTH_USERID | Az SQL Server bejelentkezési neve. |
| Munkaállomás azonosítója | SSPROP_INIT_WSID | A munkaállomás azonosítója. |
[1]: A biztonság javítása érdekében a titkosítás és a tanúsítvány validációs viselkedése módosítódik, ha az Authentication/Access Token inicializációs tulajdonságokat vagy a hozzá tartozó láncszálak kulcsszavait használják. Részletekért lásd: Titkosítás és tanúsítvány validálás.
Megjegyzés:
A kapcsolati sztringben a Old Password tulajdonság beállítja az SSPROP_AUTH_OLD_PASSWORD-t, amely az aktuális (esetleg lejárt) jelszó, és nem érhető el szolgáltatósztring-tulajdonságon keresztül.
ActiveX-adatobjektumok (ADO) kapcsolati sztringszavai
Az ADO-alkalmazások beállítják az ADODBConnection-objektumokConnectionString tulajdonságát, vagy paraméterként megadják a kapcsolati sztringet az ADODBConnection-objektumokOpen metódusának.
Az ADO-alkalmazások az OLE DB IDBInitialize::Initialize metódus által használt kulcsszavakat is használhatják, de csak az alapértelmezett értékkel nem rendelkező tulajdonságokhoz. Ha egy alkalmazás az ADO-kulcsszavakat és az IDBInitialize::Initialize keywords inicializálási sztringet is használja, a rendszer az ADO kulcsszóbeállítást használja. ajánlott, hogy az alkalmazások csak ADO kapcsolati sztring-kulcsszavakat használjanak.
Az ADO által használt kapcsolati sztringek szintaxisa a következő:
connection-string ::= empty-string[;] | attribute[;] | attribute; connection-stringempty-string ::=attribute ::= attribute-keyword=["]attribute-value["]attribute-value ::= character-stringattribute-keyword ::= identifier
Az attribútumértékek opcionálisan dupla idézőjelek közé is csatolhatók, és ezt célszerű megtenni. Ez a gyakorlat elkerüli a problémákat, ha az értékek nem alfanumerikus karaktereket tartalmaznak. Az attribútumértékek nem tartalmazhatnak idézőjeleket.
Az alábbi táblázat az ADO kapcsolati sztringdel használható kulcsszavakat ismerteti:
| Keyword | Inicializálási tulajdonság | Description |
|---|---|---|
| Hozzáférési jogkivonat1 | SSPROP_AUTH_ACCESS_TOKEN | A Microsoft Entra-azonosító hitelesítéséhez használt hozzáférési jogkivonat. JEGYZET: Hiba, ha megadjuk ezt a kulcsszót, és a UIDPWD, Trusted_Connection, vagy Authentication kapcsolati sztring kulcsszavait vagy azok tulajdonságait/kulcsszavait. |
| Alkalmazás szándéka | SSPROP_INIT_APPLICATIONINTENT | Deklarálja az alkalmazás számítási feladatainak típusát a kiszolgálóhoz való csatlakozáskor. A lehetséges értékek a következők: ReadOnly és ReadWrite.Az alapértelmezett érték a ReadWrite. További információ az SQL Server Always On rendelkezésre állási csoportokhoz nyújtott OLE DB-illesztőprogramjáról: OLE DB Driver for SQL Server Support for High Availability, Disaster Recovery. |
| Alkalmazás neve | SSPROP_INIT_APPNAME | Az alkalmazást azonosító sztring. |
| Hitelesítés 1 | SSPROP_AUTH_MODE | A használt SQL- vagy Microsoft Entra-hitelesítést adja meg. Az érvényes értékek a következők:
JEGYZET: A ActiveDirectoryIntegrated kulcsszó windowsos hitelesítéshez is használható az SQL Serverhez. Lecseréli a Integrated Security (vagy Trusted_Connection) hitelesítési kulcsszavakat. Javasoljuk, hogy a Integrated Security(vagy Trusted_Connection) kulcsszavakat vagy azok megfelelő tulajdonságait használó alkalmazások a Authentication kulcsszó (vagy annak megfelelő tulajdonsága) értékét állítsák be ActiveDirectoryIntegrated az új titkosítási és tanúsítványérvényesítési viselkedés engedélyezéséhez.JEGYZET: Javasoljuk, hogy a hitelesítést használó SQL Server alkalmazások a kulcsszó (vagy annak megfelelő tulajdonsága) értékét állítsa be az AuthenticationSqlPassword engedélyezéséhez. |
| Automatikus fordítás | SSPROP_INIT_AUTOTRANSLATE | Az OEM/ANSI karakterfordítást konfigurálja. A felismert értékek a true és a false vannak. |
| Csatlakozás időtúllépése | DBPROP_INIT_TIMEOUT | Az adatforrás inicializálásának befejezésére váró idő (másodpercben). |
| Újrapróbálkozás száma csatlakoztatása | SSPROP_INIT_CONNECT_RETRY_COUNT | A kapcsolat megszakadása esetén az újracsatlakozási kísérletek számát szabályozza. Az érvényes értékek 0 és 255 között találhatók. Az alapértelmezett érték a 1. A 0 érték nem kísérelné meg újracsatlakozni. További információ: Tétlen kapcsolat állóképessége. |
| Újrapróbálkozási időköz | SSPROP_INIT_CONNECT_RETRY_INTERVAL | A kapcsolat megszakadása esetén az egyes újrapróbálkozási kísérletek között eltelt másodpercek számát adja meg. Az érvényes értékek a 1 és 60 között terjednek. Az alapértelmezett érték a 10. További információ: Tétlen kapcsolat ellenálló képessége. |
| Aktuális nyelv | SSPROPT_INIT_CURRENTLANGUAGE | Az SQL Server nyelvének neve. |
| Adatforrás | DBPROP_INIT_DATASOURCE | Az SQL Server egy példányának neve a szervezetben. Ha nincs megadva, a rendszer kapcsolatot létesít a helyi számítógép alapértelmezett példányával. Az érvényes címszintaxissal kapcsolatos további információkért tekintse meg a kiszolgáló kulcsszójának leírását ebben a cikkben. |
| DataTypeCompatibility | SSPROP_INIT_DATATYPECOMPATIBILITY | Megadja a használni kívánt adattípus-kezelés módját. A felismert értékek a 0 szolgáltatói adattípusokhoz és 80 az SQL Server 2000 adattípusokhoz tartoznak. |
| Feladatátvételi partner | SSPROP_INIT_FAILOVERPARTNER | Az adatbázis-tükrözéshez használt átvételi kiszolgáló neve. |
| Átállási partner SPN | SSPROP_INIT_FAILOVERPARTNERSPN | A feladatátvevő partner SPN-je. Az alapértelmezett érték egy üres sztring. Egy üres sztring miatt az SQL Serverhez készült OLE DB-illesztő az alapértelmezett, szolgáltató által generált SPN-t használja. |
| Hostnév a tanúsítványban | SSPROP_INIT_HOST_NAME_CERTIFICATE | Az SQL Server TLS/SSL-tanúsítvány érvényesítéséhez használandó állomásnév. Ha a tanúsítvány gazdagépneve kulcsszó nincs beállítva, a meghajtó a kapcsolat URL-jében szereplő Adatforrás kulcsszó értékét használja állomásnévként az SQL Server TLS/SSL-tanúsítvány érvényesítéséhez. JEGYZET: A rendszer figyelmen kívül hagyja ezt a tulajdonságot, ha a kiszolgálótanúsítvány megbízható. Ha a Use Encryption for Data (Adattitkosítás használata) értékre van állítva Strict, a tanúsítvány mindig érvényesítve lesz. |
| Alapkatalógus | DBPROP_INIT_CATALOG | Az adatbázis neve. |
| Kezdeti fájlnév | SSPROP_INIT_FILENAME | Egy csatolható adatbázis elsődleges fájljának neve (a teljes elérési utat is tartalmazza). AttachDBFileName használatához meg kell adnia az adatbázis nevét a |
| Integrált biztonság | DBPROP_AUTH_INTEGRATED | Elfogadja a Windows-hitelesítés értékét SSPI . |
| MARS-kapcsolat | SSPROP_INIT_MARSCONNECTION | Több aktív eredményhalmaz (MARS) engedélyezése vagy letiltása a kapcsolaton, ha a kiszolgáló SQL Server 2005 (9.x) vagy újabb. A felismert értékek a true és a false vannak. Az alapértelmezett érték a false. |
| MultiSubnetFailover | SSPROP_INIT_MULTISUBNETFAILOVER | Mindig adja meg a MultiSubnetFailover=True értéket, amikor egy SQL Server rendelkezésre állási csoport vagy egy SQL Server feladatátvevőfürt-példány rendelkezésre állási csoportfigyelőjével csatlakozik.
A MultiSubnetFailover=True úgy konfigurálja az OLE DB-illesztőt az SQL Serverhez, hogy gyorsabb észlelést és kapcsolatot biztosítson az (jelenleg) aktív kiszolgálóhoz. A lehetséges értékek a következők: True és False. Az alapértelmezett érték a False. Például:MultiSubnetFailover=TrueTovábbi információ az SQL Server Always On rendelkezésre állási csoportokhoz nyújtott OLE DB-illesztőprogramjáról: OLE DB Driver for SQL Server Support for High Availability, Disaster Recovery. |
| Hálózati cím | SSPROP_INIT_NETWORKADDRESS | Az SQL Server egy példányának hálózati címe a szervezetben. Az érvényes címszintaxissal kapcsolatos további információkért tekintse meg a Cím kulcsszó leírását ebben a cikkben. |
| Hálózati kódtár | SSPROP_INIT_NETWORKLIBRARY | A szervezet SQL Server-példányával létesített kapcsolat létesítéséhez használt hálózati kódtár. |
| Csomagméret | SSPROP_INIT_PACKETSIZE | Táblázatos adatfolyam (TDS) csomagmérete. Az alapértelmezett érték 0 (a tényleges értéket a kiszolgáló határozza meg). |
| Jelszó | DBPROP_AUTH_PASSWORD | Az SQL Server bejelentkezési jelszava. |
| Biztonsági adatok megőrzése | DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO | Elfogadja a sztringeket true és false mint értékeket. Amikor falseaz adatforrás-objektum nem őrizheti meg a bizalmas hitelesítési adatokat. |
| Szolgáltató | Az SQL Server OLE DB-illesztőprogramjának értéke MSOLEDBSQL19 vagy MSOLEDBSQL. |
|
| Kiszolgálói tanúsítvány | SSPROP_INIT_SERVER_CERTIFICATE | Megadja az SQL Server TLS/SSL-tanúsítványnak megfelelő tanúsítványfájl elérési útját. Ez a beállítás csak akkor használható, ha Strict a titkosítás engedélyezve van. Az elfogadott tanúsítványformátumok a PEM, a DER és a CER. Ha meg van adva, a rendszer ellenőrzi az SQL Server-tanúsítványt, és ellenőrzi, hogy a megadott tanúsítvány pontosan egyezik-e. |
| Kiszolgálói SPN | SSPROP_INIT_SERVERSPN | A kiszolgáló SPN-je. Az alapértelmezett érték egy üres sztring. Egy üres sztring miatt az SQL Serverhez készült OLE DB-illesztő az alapértelmezett, szolgáltató által generált SPN-t használja. |
| TransparentNetworkIPResolution | SSPROP_INIT_TNIR | Hatással van a kapcsolatsorrendre, ha az első feloldott IP-cím nem válaszol, és az IP címhez több IP van társítva. A TNIR együttműködik a MultiSubnetFailover szolgáltatással, hogy különböző kapcsolatütemezéseket biztosítson. A lehetséges értékek a következők: True és False. Az alapértelmezett érték a True. További információ: Transzparens hálózati IP-felbontás használata. |
| Kiszolgáló megbízhatósági tanúsítvány1 | SSPROP_INIT_TRUST_SERVER_CERTIFICATE | Elfogadja a sztringeket true és false mint értékeket. Az alapértelmezett érték az false, ami azt jelenti, hogy a kiszolgálótanúsítvány érvényesítve lesz. |
| Adatok titkosítása1 | SSPROP_INIT_ENCRYPT | Megadja, hogy az adatok titkosítva legyenek-e a hálózaton keresztüli küldés előtt. A lehetséges értékek a következők: Optional, Mandatoryés Strict. Az alapértelmezett érték a Mandatory. A 18.x.x verziókkal kapcsolatban lásd az MSOLEDBSQL főverzió-eltéréseit. |
| FMTONLY használata | SSPROP_INIT_USEFMTONLY | A metaadatok lekérésének módját szabályozza az SQL Server 2012 -hez (11.x) és újabbhoz való csatlakozáskor. A lehetséges értékek a következők: true és false. Az alapértelmezett érték a false.Az SQL Server OLE DB-illesztőprogramja alapértelmezés szerint sp_describe_first_result_set és sp_describe_undeclared_parameters tárolt eljárásokat használ a metaadatok lekéréséhez. Ezek a tárolt eljárások bizonyos korlátozásokkal rendelkeznek (például az ideiglenes táblákon való működés során sikertelenek lesznek). A beállítás az FMTONLY true használatával arra utasítja az illesztőprogramot, hogy ehelyett a SET FMTONLY függvényt használja a metaadatok lekéréséhez. |
| Felhasználóazonosító | DBPROP_AUTH_USERID | Az SQL Server bejelentkezési neve. |
| Munkaállomás azonosítója | SSPROP_INIT_WSID | A munkaállomás azonosítója. |
[1]: A biztonság javítása érdekében a titkosítás és a tanúsítvány validációs viselkedése módosítódik, ha az Authentication/Access Token inicializációs tulajdonságokat vagy a hozzá tartozó láncszálak kulcsszavait használják. Részletekért lásd: Titkosítás és tanúsítvány validálás.
Megjegyzés:
A kapcsolati sztringben a "Régi jelszó" tulajdonság az SSPROP_AUTH_OLD_PASSWORD-ot állítja be, amely az aktuális (esetleg lejárt) jelszó, és nem érhető el szolgáltatói tulajdonságként.