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 Server
Azure SQL Database
Azure SQL Managed Instance
Azure Synapse Analytics
Analitikai 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ásához (például egyes kulcsszavak többször is megadhatóak, é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::InitializeIDataInitialize::GetDataSource
Az első esetben egy szolgáltatói sztring használható a kapcsolat tulajdonságainak inicializálására a DBPROP_INIT_PROVIDERSTRING tulajdonságkészletben lévő tulajdonság DBPROPSET_DBINIT beállításával. A második esetben egy inicializálási sztring továbbítható a metódusnak IDataInitialize::GetDataSource 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. A használt IDataInitialize::GetDataSource kulcsszavak készlete 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ó sztringekben megadott DBPROP_INIT_PROVIDERSTRING értékek révén beállított logikai tulajdonságok az yes és no értékekkel vannak beállítva. A kezdeti beállításokban IDataInitialize::GetDataSource megadott logikai tulajdonságok true és false értékekkel vannak beállítva.
A IDataInitialize::GetDataSource alkalmazások használhatják a IDBInitialize::Initialize által használt kulcsszavakat is, de csak azokra a tulajdonságokra vonatkozik ez, amelyek nem rendelkeznek alapértelmezett értékkel. Ha egy alkalmazás a IDataInitialize::GetDataSource kulcsszót és a IDBInitialize::Initialize kulcsszót is használja az inicializálási sztringben, a IDataInitialize::GetDataSource kulcsszóbeállítást használja a rendszer. Javasoljuk, hogy az alkalmazások ne használjanak IDBInitialize::Initialize kulcsszavakat a IDataInitialize:GetDataSource kapcsolati sztringekben, mivel ez a viselkedés a későbbi kiadásokban nem tartható fenn.
Megjegyzés:
Az IDataInitialize::GetDataSource átadott kapcsolati sztring tulajdonságokká alakul, és a rendszer IDBProperties::SetProperties segítségével alkalmazza. Ha az összetevő-szolgáltatások a tulajdonság leírását IDBProperties::GetPropertyInfotalálták meg, a tulajdonság önálló tulajdonságként lesz alkalmazva. Ellenkező esetben a DBPROP_PROVIDERSTRING tulajdonságon keresztül alkalmazásra kerül. Ha például megadja a kapcsolati sztringet Data Source=server1;Server=server2, Data Source az tulajdonságként lesz beállítva, de Server 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 DBPROP_INIT_PROVIDERSTRING és IDBInitialize::Initialize használó OLE DB-alkalmazások által használt kapcsolati sztringek a következő szintaxisúak:
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 használható kulcsszavakat DBPROP_INIT_PROVIDERSTRING ismerteti.
| Keyword | Inicializálási tulajdonság | Description |
|---|---|---|
Addr |
SSPROP_INIT_NETWORKADDRESS |
Szinonimája a következőhöz Address: . |
Address |
SSPROP_INIT_NETWORKADDRESS |
Az SQL Server egy példányát futtató kiszolgáló hálózati címe.
Address általában a kiszolgáló hálózati neve, de lehet más is, például csővezeték, IP-cím, vagy TCP/IP-port és foglalatcí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. Address értéke elsőbbséget élvez a kapcsolati sztringekben szereplő Server értékkel szemben, ha az OLE DB-illesztőprogramot használja az SQL Serverhez.
Address=; a kulcsszóban Server megadott kiszolgálóhoz csatlakozik, míg Address= ;, Address=.;a , Address=localhost;és Address=(local); mindegyik kapcsolatot okoz a helyi kiszolgálóval.A kulcsszó teljes szintaxisa a Address 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 kulcsszó nincs megadva, az Network 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. Alapértelmezés szerint az SQL Server portot 1433használ. |
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). A AttachDBFileName használatához meg kell adnia az adatbázis nevét is a "Database" kulcsszóval a szolgáltatói stringben. 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). |
Authentication
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:
Megjegyzés: A ActiveDirectoryIntegrated kulcsszó használható Windows hitelesítésére is SQL Serverhez. Lecseréli a Integrated Security (vagy Trusted_Connection) hitelesítési kulcsszavakat. Az alkalmazások, amelyek Integrated Security kulcsszavakat vagy azok tulajdonságait használnak, Trusted_Connectionbe kell állítaniuk a Authentication kulcsszó értékét (vagy annak megfelelő tulajdonságát ActiveDirectoryIntegrated ), hogy új titkosítást és tanúsítvány validációs viselkedést engedélyezzenek.Megjegyzés: Az SQL Server hitelesítést használó alkalmazásoknak be kell állítaniuk a Authentication kulcsszó értékét (vagy annak megfelelő tulajdonságát SqlPassword ), hogy új titkosítást és tanúsítvány validációs viselkedést engedélyezzenek. |
Auto Translate |
SSPROP_INIT_AUTOTRANSLATE |
Szinonimája a következőhöz AutoTranslate: . |
AutoTranslate |
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. Ha az érték 0, akkor nem történik meg újracsatlakozási kísérlet. További információ: Tétlen kapcsolat rugalmassága az OLE DB-illesztőprogramban. |
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 rugalmassága az OLE DB-illesztőprogramban. |
Database |
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 0 a szolgáltatói adattípusokhoz és 80 az SQL Server 2000 (8.x) adattípusokhoz tartoznak. |
Encrypt
1 |
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. |
FailoverPartner |
SSPROP_INIT_FAILOVERPARTNER |
Az adatbázis-tükrözéshez használt átvételi kiszolgáló neve. |
FailoverPartnerSPN |
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őprogram a Server kapcsolati URL-cím kulcsszóértékét használja állomásnévként az SQL Server TLS/SSL-tanúsítvány ellenőrzéséhez.Megjegyzés: A rendszer figyelmen kívül hagyja ezt a tulajdonságot, ha a kiszolgálótanúsítvány megbízható. Ha Encrypt be van állítva Strict, a tanúsítvány mindig érvényesítve lesz. |
Language |
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 |
A MultiSubnetFailover=Yes paramétert mindig adja meg, amikor csatlakozik egy SQL Server rendelkezésre állási csoport figyelőjéhez vagy egy SQL Server feladatátvételi fürt példányához.
MultiSubnetFailover=Yes Konfigurálja az OLE DB-illesztőprogramot 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 |
Szinonimája a következőhöz Network: . |
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. |
Network Library |
SSPROP_INIT_NETWORKLIBRARY |
Szinonimája a következőhöz Network: . |
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. |
Server |
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 Address kulcsszó felülírja a kulcsszót Server .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=(local);Server=(local);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á \<InstanceName>.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 kulcsszó teljes szintaxisa a Server következő:[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 kulcsszó nincs megadva, az Network 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. Alapértelmezés szerint az SQL Server portot 1433használ.A rendszer figyelmen kívül hagyja a szóközöket a kapcsolati láncokban megadott Server érték elején, amikor OLE DB-meghajtót használ az SQL Serverhez. |
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. |
Timeout |
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. |
TrustServerCertificate
1 |
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 beállítás UseFMTONLY arra utasítja az illesztőprogramot, hogy ehelyett a yes 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, a titkosítás és a tanúsítványérvényesítési viselkedés 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 módosul. 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 IDataInitialize::GetDataSource által használt kapcsolati sztringek szintaxisa a következő:
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. Például a WSID kapcsos zárójeleket ({}) idézőjel karaktereket használ, míg a Application Name egyes (') vagy dupla idézőjeleket (") 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 ismerteti a IDataInitialize::GetDataSource-vel használható kulcsszavakat:
| Keyword | Inicializálási tulajdonság | Description |
|---|---|---|
Access Token
1 |
SSPROP_AUTH_ACCESS_TOKEN |
A Microsoft Entra-azonosító hitelesítéséhez használt hozzáférési jogkivonat. Megjegyzés: Hiba ezt a kulcsszót és UID, PWD, Trusted_Connection vagy Authentication kapcsolati karakterlánc kulcsszavakat vagy azok tulajdonságait vagy kulcsszavait megadni. |
Application Name |
SSPROP_INIT_APPNAME |
Az alkalmazást azonosító sztring. |
Application Intent |
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. |
Authentication
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:
Megjegyzés: A ActiveDirectoryIntegrated kulcsszó használható Windows hitelesítésére is SQL Serverhez. Lecseréli a Integrated Security (vagy Trusted_Connection) hitelesítési kulcsszavakat. Az alkalmazások, amelyek Integrated Security kulcsszavakat vagy azok tulajdonságait használnak, Trusted_Connectionbe kell állítaniuk a Authentication kulcsszó értékét (vagy annak megfelelő tulajdonságát ActiveDirectoryIntegrated ), hogy új titkosítást és tanúsítvány validációs viselkedést engedélyezzenek.Megjegyzés: Az SQL Server hitelesítést használó alkalmazásoknak be kell állítaniuk a Authentication kulcsszó értékét (vagy annak megfelelő tulajdonságát SqlPassword ), hogy új titkosítást és tanúsítvány validációs viselkedést engedélyezzenek. |
Auto Translate |
SSPROP_INIT_AUTOTRANSLATE |
Az OEM/ANSI karakterfordítást konfigurálja. A felismert értékek a true és a false vannak. |
Connect Timeout |
DBPROP_INIT_TIMEOUT |
Az adatforrás inicializálásának befejezésére váró idő (másodpercben). |
Connect Retry Count |
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 ahhoz vezetne, hogy nem történik meg az újracsatlakozási kísérlet. További információ: Tétlen kapcsolat rugalmassága az OLE DB-illesztőprogramban. |
Connect Retry Interval |
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 rugalmassága az OLE DB-illesztőprogramban. |
Current Language |
SSPROPT_INIT_CURRENTLANGUAGE |
Az SQL Server nyelvének neve. |
Data Source |
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 kulcsszó leírását ebben a Server 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. |
Failover Partner |
SSPROP_INIT_FAILOVERPARTNER |
Az adatbázis-tükrözéshez használt átvételi kiszolgáló neve. |
Failover 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. |
Host Name In Certificate |
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 Host Name In Certificate kulcsszó nincs beállítva, az illesztőprogram a Data Source kapcsolati URL-cím kulcsszóértékét használja állomásnévként az SQL Server TLS/SSL-tanúsítvány ellenőrzéséhez.Megjegyzés: A rendszer figyelmen kívül hagyja ezt a tulajdonságot, ha a kiszolgálótanúsítvány megbízható. Ha Use Encryption for Data be van állítva Strict, a tanúsítvány mindig érvényesítve lesz. |
Initial Catalog |
DBPROP_INIT_CATALOG |
Az adatbázis neve. |
Initial File Name |
SSPROP_INIT_FILENAME |
Egy csatolható adatbázis elsődleges fájljának neve (a teljes elérési utat is tartalmazza). A AttachDBFileName használatához meg kell adnia az adatbázis nevét is a DATABASE kulcsszóval a szolgáltatói karaktersorozatban. 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). |
Integrated Security |
DBPROP_AUTH_INTEGRATED |
Elfogadja a Windows-hitelesítés értékét SSPI . |
MARS Connection |
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 |
A MultiSubnetFailover=True paramétert mindig adja meg, amikor csatlakozik egy SQL Server rendelkezésre állási csoport figyelőjéhez vagy egy SQL Server feladatátvételi fürt példányához.
MultiSubnetFailover=True Konfigurálja az OLE DB-illesztőprogramot 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. |
Network Address |
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 kulcsszó leírását ebben a Address cikkben. |
Network Library |
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. |
Packet Size |
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). |
Password |
DBPROP_AUTH_PASSWORD |
Az SQL Server bejelentkezési jelszava. |
Persist Security Info |
DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO |
Elfogadja a sztringeket true és false mint értékeket. Amikor falseaz adatforrás-objektum nem őrizhet meg bizalmas hitelesítési adatokat |
Provider |
Az SQL Server OLE DB-illesztőprogramjának értéke MSOLEDBSQL19 vagy MSOLEDBSQL. |
|
Server Certificate |
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. |
Server 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. |
Trust Server Certificate
1 |
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. |
Use Encryption for Data
1 |
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. |
Use FMTONLY |
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 Use FMTONLY arra utasítja az illesztőprogramot, hogy ehelyett a true függvényt használja a metaadatok lekéréséhez. |
User ID |
DBPROP_AUTH_USERID |
Az SQL Server bejelentkezési neve. |
Workstation ID |
SSPROP_INIT_WSID |
A munkaállomás azonosítója. |
1 A biztonság, a titkosítás és a tanúsítványérvényesítési viselkedés a hitelesítési/hozzáférési jogkivonat inicializálási tulajdonságainak vagy a megfelelő kapcsolati sztring-kulcsszavaknak a használatakor módosul. 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 SSPROP_AUTH_OLD_PASSWORDaz aktuális (esetleg lejárt) jelszót, amely nem érhető el szolgáltatói sztringtulajdonságon keresztül.
ActiveX-adatobjektumok (ADO) kapcsolati sztringszavai
Az ADO-alkalmazások beállítják az ConnectionString objektumok tulajdonságát ADODBConnection , vagy egy kapcsolati sztringet ad meg paraméterként az Open objektumok metódusához ADODBConnection .
Az ADO-alkalmazások az OLE DB IDBInitialize::Initialize metódus által használt kulcsszavakat is használhatják, de csak olyan tulajdonságokhoz, amelyek nem rendelkeznek alapértelmezett értékkel. Ha egy alkalmazás az ADO-kulcsszavakat és az IDBInitialize::Initialize inicializálási sztringben szereplő kulcsszavakat is használja, a rendszer az ADO kulcsszóbeállítást fogja használni. 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 |
|---|---|---|
Access Token
1 |
SSPROP_AUTH_ACCESS_TOKEN |
A Microsoft Entra-azonosító hitelesítéséhez használt hozzáférési jogkivonat. Megjegyzés: Hiba ezt a kulcsszót és a UID, PWD, Trusted_Connection vagy Authentication kapcsolati sztring kulcsszavakat vagy azok tulajdonságait vagy kulcsszavait megadni. |
Application Intent |
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. |
Application Name |
SSPROP_INIT_APPNAME |
Az alkalmazást azonosító sztring. |
Authentication
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:
Megjegyzés: A ActiveDirectoryIntegrated kulcsszó használható Windows hitelesítésére is SQL Serverhez. Lecseréli a Integrated Security (vagy Trusted_Connection) hitelesítési kulcsszavakat. Az alkalmazások, amelyek Integrated Security kulcsszavakat vagy azok tulajdonságait használnak, Trusted_Connectionbe kell állítaniuk a Authentication kulcsszó értékét (vagy annak megfelelő tulajdonságát ActiveDirectoryIntegrated ), hogy új titkosítást és tanúsítvány validációs viselkedést engedélyezzenek.Megjegyzés: Az SQL Server hitelesítést használó alkalmazásoknak be kell állítaniuk a Authentication kulcsszó értékét (vagy annak megfelelő tulajdonságát SqlPassword ), hogy új titkosítást és tanúsítvány validációs viselkedést engedélyezzenek. |
Auto Translate |
SSPROP_INIT_AUTOTRANSLATE |
Az OEM/ANSI karakterfordítást konfigurálja. A felismert értékek a true és a false vannak. |
Connect Timeout |
DBPROP_INIT_TIMEOUT |
Az adatforrás inicializálásának befejezésére váró idő (másodpercben). |
Connect Retry Count |
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 esetén nem történik meg az újracsatlakozás. További információ: Tétlen kapcsolat rugalmassága az OLE DB-illesztőprogramban. |
Connect Retry Interval |
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 rugalmassága az OLE DB-illesztőprogramban. |
Current Language |
SSPROPT_INIT_CURRENTLANGUAGE |
Az SQL Server nyelvének neve. |
Data Source |
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 kulcsszó leírását ebben a Server 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. |
Failover Partner |
SSPROP_INIT_FAILOVERPARTNER |
Az adatbázis-tükrözéshez használt átvételi kiszolgáló neve. |
Failover 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. |
Host Name In Certificate |
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 Host Name In Certificate kulcsszó nincs beállítva, az illesztőprogram a Data Source kapcsolati URL-cím kulcsszóértékét használja állomásnévként az SQL Server TLS/SSL-tanúsítvány ellenőrzéséhez.Megjegyzés: A rendszer figyelmen kívül hagyja ezt a tulajdonságot, ha a kiszolgálótanúsítvány megbízható. Ha Use Encryption for Data be van állítva Strict, a tanúsítvány mindig érvényesítve lesz. |
Initial Catalog |
DBPROP_INIT_CATALOG |
Az adatbázis neve. |
Initial File Name |
SSPROP_INIT_FILENAME |
Egy csatolható adatbázis elsődleges fájljának neve (a teljes elérési utat is tartalmazza). A AttachDBFileName használatához meg kell adnia az adatbázis nevét is a paraméterlánc DATABASE kulcsszó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). |
Integrated Security |
DBPROP_AUTH_INTEGRATED |
Elfogadja a Windows-hitelesítés értékét SSPI . |
MARS Connection |
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 |
A MultiSubnetFailover=True paramétert mindig adja meg, amikor csatlakozik egy SQL Server rendelkezésre állási csoport figyelőjéhez vagy egy SQL Server feladatátvételi fürt példányához.
MultiSubnetFailover=True Konfigurálja az OLE DB-illesztőprogramot 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. |
Network Address |
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 kulcsszó leírását ebben a Address cikkben. |
Network Library |
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. |
Packet Size |
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). |
Password |
DBPROP_AUTH_PASSWORD |
Az SQL Server bejelentkezési jelszava. |
Persist Security Info |
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. |
Provider |
Az SQL Server OLE DB-illesztőprogramjának értéke MSOLEDBSQL19 vagy MSOLEDBSQL. |
|
Server Certificate |
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. |
Server 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. |
Trust Server Certificate
1 |
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. |
Use Encryption for Data
1 |
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. |
Use FMTONLY |
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 Use FMTONLY arra utasítja az illesztőprogramot, hogy ehelyett a true függvényt használja a metaadatok lekéréséhez. |
User ID |
DBPROP_AUTH_USERID |
Az SQL Server bejelentkezési neve. |
Workstation ID |
SSPROP_INIT_WSID |
A munkaállomás azonosítója. |
1 A biztonság, a titkosítás és a tanúsítványérvényesítési viselkedés a hitelesítési/hozzáférési jogkivonat inicializálási tulajdonságainak vagy a megfelelő kapcsolati sztring-kulcsszavaknak a használatakor módosul. 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 SSPROP_AUTH_OLD_PASSWORD értéke az aktuális (esetleg lejárt) jelszó, amely nem érhető el egy szolgáltatói sztringtulajdonságon keresztül.