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.
Ez a lap az SQL Server ODBC-illesztőprogramjában elérhető SQLSetConnectAttr és SQLGetConnectAttr kapcsolati sztringekhez és DSN-ekhez, valamint kapcsolati attribútumokhoz tartozó kulcsszavakat sorolja fel.
Támogatott DSN/Kapcsolati sztring kulcsszavak és kapcsolati attribútumok
Az alábbi táblázat az egyes platformokhoz (L: Linux) elérhető kulcsszavakat és attribútumokat sorolja fel. M: macOS; W: Windows). További részletekért válassza ki a kulcsszót vagy az attribútumot.
Az alábbiakban néhány kapcsolati sztring-kulcsszót és kapcsolati attribútumot talál, amelyek nincsenek dokumentálva az SQL Server natív ügyféllel, az SQLSetConnectAttr és az SQLSetConnectAttr függvénykapcsolati sztringszavaival.
Description
Az adatforrás leírására szolgál.
SQL_COPT_SS_ANSI_OEM
Szabályozza az ADATOK ANSI-ről OEM-re való konvertálását.
| Attribútumérték | Description |
|---|---|
| SQL_AO_OFF | (Alapértelmezett) A fordítás nem történik meg. |
| SQL_AO_ON | A fordítás kész. |
SQL_COPT_SS_AUTOBEGINTXN
17.6-os verzió+ Ha az automatikus üzenetküldés ki van kapcsolva, a VISSZAÁLLÍTÁS vagy VÉGLEGESÍTÉS után az automatikus BEGIN TRANZAKCIÓt vezérli.
| Attribútumérték | Description |
|---|---|
| SQL_AUTOBEGINTXN_ON | (Alapértelmezett) Automatikus KEZDŐ TRANZAKCIÓ A VISSZAÁLLÍTÁS VAGY VÉGLEGESÍTÉS után. |
| SQL_AUTOBEGINTXN_OFF | A VISSZAÁLLÍTÁS VAGY VÉGLEGESÍTÉS után nincs automatikus BEGIN TRANZAKCIÓ. |
SQL_COPT_SS_FALLBACK_CONNECT
Az SQL Server tartalék kapcsolatainak használatát szabályozza. Ez már nem támogatott.
| Attribútumérték | Description |
|---|---|
| SQL_FB_OFF | (Alapértelmezett) A tartalék kapcsolatok le vannak tiltva. |
| SQL_FB_ON | A tartalék kapcsolatok engedélyezve vannak. |
Új kapcsolati sztringszavak és kapcsolati attribútumok
Hitelesítés – SQL_COPT_SS_AUTHENTICATION
Beállítja az SQL Serverhez való csatlakozáshoz használni kívánt hitelesítési módot. További információ: A Microsoft Entra ID használata.
| Kulcsszó értéke | Attribútumérték | Description |
|---|---|---|
| SQL_AU_NONE | (Alapértelmezett) Nincs beállítva. Más attribútumok kombinációja határozza meg a hitelesítési módot. | |
| SqlPassword | SQL_AU_PASSWORD | SQL Server-hitelesítés felhasználónévvel és jelszóval. |
| ActiveDirectoryIntegrated | SQL_AU_AD_INTEGRATED | Microsoft Entra integrált hitelesítés. |
| ActiveDirectoryPassword | SQL_AU_AD_PASSWORD | Microsoft Entra jelszóhitelesítés. |
| ActiveDirectoryInteractive | SQL_AU_AD_INTERACTIVE | Microsoft Entra Interaktív hitelesítés. |
| ActiveDirectoryMsi | SQL_AU_AD_MSI | Microsoft Entra által felügyelt identitáshitelesítés. A felhasználó által hozzárendelt identitás esetében az UID a felhasználói identitás objektumazonosítójára van állítva. |
| ActiveDirectoryServicePrincipal | SQL_AU_AD_SPA | Microsoft Entra szolgáltatásnév hitelesítése. A UID a szolgáltatásnév ügyfél-azonosítójára van állítva. A PWD az ügyfél titkos kódjára van állítva. |
| SQL_AU_RESET | Foglalatból kivesz. Felülbírálja a DSN vagy a kapcsolati sztring beállításait. |
Megjegyzés:
Kulcsszó vagy attribútum használatakor Authentication explicit módon adja meg a kívánt érték beállítását Encrypt a kapcsolati sztringben/ DSN/kapcsolatattribútumban. A részletekért tekintse meg a kapcsolati sztringszavak sql serveres natív ügyféllel való használatát .
ColumnEncryption – SQL_COPT_SS_COLUMN_ENCRYPTION
Transzparens oszloptitkosítást (Always Encrypted) vezérel. További információ: Always Encrypted (ODBC) használata.
| Kulcsszó értéke | Attribútumérték | Description |
|---|---|---|
| Enabled | SQL_CE_ENABLED | Engedélyezi az Always Encryptedt. |
| Disabled | SQL_CE_DISABLED | (Alapértelmezett) Letiltja az Always Encrypted szolgáltatást. |
| SQL_CE_RESULTSETONLY | Csak a visszafejtést engedélyezi (eredmények és visszaadott értékek). |
Titkosít
Megadja, hogy a kapcsolatok TLS-titkosítást használnak-e a hálózaton keresztül. A lehetséges értékek a következőkyes/mandatory: (18,0+),optionalno/ (18,0+) és strict(18,0+). Az alapértelmezett érték a yes 18.0-s vagy újabb verzióban és no a korábbi verziókban van.
A kiszolgáló bejelentkezési hitelesítő adatai (felhasználónév és jelszó) a beállítástól Encryptfüggetlenül mindig titkosítva vannak.
Encrypt, TrustServerCertificateés a kiszolgálóoldali Force Encryption beállítások szerepet játszanak abban, hogy a kapcsolatok titkosítva vannak-e a hálózaton keresztül. Az alábbi táblázatok a beállítások hatását mutatják be.
ODBC Driver 18 és újabb
| Titkosítási beállítás | Megbízhatósági kiszolgáló tanúsítványa | Kiszolgáló kényszerítő titkosítása | Eredmény |
|---|---|---|---|
| Nem | Nem | Nem | A kiszolgálótanúsítvány nincs bejelölve. Az ügyfél és a kiszolgáló között küldött adatok nincsenek titkosítva. |
| Nem | Igen | Nem | A kiszolgálótanúsítvány nincs bejelölve. Az ügyfél és a kiszolgáló között küldött adatok nincsenek titkosítva. |
| Igen | Nem | Nem | A kiszolgálótanúsítvány be van jelölve. Az ügyfél és a kiszolgáló között küldött adatok titkosítva lesznek. |
| Igen | Igen | Nem | A kiszolgálótanúsítvány nincs bejelölve. Az ügyfél és a kiszolgáló között küldött adatok titkosítva lesznek. |
| Nem | Nem | Igen | A kiszolgálótanúsítvány be van jelölve. Az ügyfél és a kiszolgáló között küldött adatok titkosítva lesznek. |
| Nem | Igen | Igen | A kiszolgálótanúsítvány nincs bejelölve. Az ügyfél és a kiszolgáló között küldött adatok titkosítva lesznek. |
| Igen | Nem | Igen | A kiszolgálótanúsítvány be van jelölve. Az ügyfél és a kiszolgáló között küldött adatok titkosítva lesznek. |
| Igen | Igen | Igen | A kiszolgálótanúsítvány nincs bejelölve. Az ügyfél és a kiszolgáló között küldött adatok titkosítva lesznek. |
| Szigorú | - | - | A TrustServerCertificate figyelmen kívül lesz hagyva. A kiszolgálótanúsítvány be van jelölve. Az ügyfél és a kiszolgáló között küldött adatok titkosítva lesznek. |
Megjegyzés:
Szigorú csak a TDS 8.0-kapcsolatokat támogató kiszolgálókon érhető el.
ODBC Driver 17 és újabb
| Titkosítási beállítás | Megbízhatósági kiszolgáló tanúsítványa | Kiszolgáló kényszerítő titkosítása | Eredmény |
|---|---|---|---|
| Nem | Nem | Nem | A kiszolgálótanúsítvány nincs bejelölve. Az ügyfél és a kiszolgáló között küldött adatok nincsenek titkosítva. |
| Nem | Igen | Nem | A kiszolgálótanúsítvány nincs bejelölve. Az ügyfél és a kiszolgáló között küldött adatok nincsenek titkosítva. |
| Igen | Nem | Nem | A kiszolgálótanúsítvány be van jelölve. Az ügyfél és a kiszolgáló között küldött adatok titkosítva lesznek. |
| Igen | Igen | Nem | A kiszolgálótanúsítvány nincs bejelölve. Az ügyfél és a kiszolgáló között küldött adatok titkosítva lesznek. |
| Nem | Nem | Igen | A kiszolgálótanúsítvány nincs bejelölve. Az ügyfél és a kiszolgáló között küldött adatok titkosítva lesznek. |
| Nem | Igen | Igen | A kiszolgálótanúsítvány nincs bejelölve. Az ügyfél és a kiszolgáló között küldött adatok titkosítva lesznek. |
| Igen | Nem | Igen | A kiszolgálótanúsítvány be van jelölve. Az ügyfél és a kiszolgáló között küldött adatok titkosítva lesznek. |
| Igen | Igen | Igen | A kiszolgálótanúsítvány nincs bejelölve. Az ügyfél és a kiszolgáló között küldött adatok titkosítva lesznek. |
TransparentNetworkIPResolution – SQL_COPT_SS_TNIR
Szabályozza a Transzparens hálózati IP-felbontás funkciót, amely a MultiSubnetFailover szolgáltatással együttműködve lehetővé teszi a gyorsabb újracsatlakozási kísérleteket. További információ: Transzparens hálózati IP-felbontás használata.
| Kulcsszó értéke | Attribútumérték | Description |
|---|---|---|
| Enabled | SQL_IS_ON | (Alapértelmezett) Lehetővé teszi a transzparens hálózati IP-felbontást. |
| Disabled | SQL_IS_OFF | Letiltja a transzparens hálózati IP-felbontást. |
UseFMTONLY
A SET FMTONLY metaadatokhoz való használatát szabályozza az SQL Server 2012-hez és újabbhoz való csatlakozáskor.
| Kulcsszó értéke | Description |
|---|---|
| Nem | (Alapértelmezett) Ha elérhető, használja a sp_describe_first_result_set metaadatokat. |
| Igen | A SET FMTONLY használata metaadatokhoz. |
Replication
Megadja a replikációs bejelentkezés használatát az ODBC-illesztőprogram 17.8-s és újabb verziójában.
| Kulcsszó értéke | Description |
|---|---|
| Nem | (Alapértelmezett) A replikációs bejelentkezés nem használatos. |
| Igen | A beállítással rendelkező NOT FOR REPLICATION triggerek nem aktiválják a kapcsolatot. |
RetryExec
A konfigurálható újrapróbálkozás logikája a 18.1-es verziótól érhető el. Konfigurálható feltételek alapján automatikusan újra végrehajt bizonyos ODBC-függvényhívásokat. Ez a funkció a kapcsolati sztringen keresztül engedélyezhető a RetryExec kulcsszóval, valamint az újrapróbálkozási szabályok listájával. Minden újrapróbálkozési szabály három kettősponttal elválasztott összetevővel rendelkezik: hibaegyeztetés, újrapróbálkozás és lekérdezésegyezés.
A lekérdezési egyezés meghatározza az adott végrehajtáshoz használandó újrapróbálkozási szabályt, és megfelel a bejövő parancsszövegnek (SQLExecDirect) vagy az utasításobjektumban (SQLExecute) szereplő előkészített parancsszövegnek. Ha egynél több szabály egyezik, a rendszer a listában szereplő első egyezőt használja. Ez a viselkedés lehetővé teszi a szabályok felsorolását az általánosság növelése érdekében. Ha nincs szabály egyezés, akkor a rendszer nem alkalmaz újrapróbálkozásokat.
Ha a végrehajtás hibát eredményez, és van egy alkalmazható újrapróbálkozási szabály, annak hibaegyezése határozza meg, hogy a végrehajtást újra kell-e próbálkozni.
A RetryExec kulcsszó értéke pontosvesszővel elválasztott újrapróbálkozési szabályok listája.
RetryExec={rule1;rule2}
Az újrapróbálkozások szabálya a következő: <errormatch>:<retrypolicy>:<querymatch>
Hibaegyezés: A hibakódok vesszővel tagolt listája. Az 1000 2000-et például az újrapróbálkozni kívánt hibakódok adhatja meg.
Újrapróbálkozás szabályzata: Megadja a késleltetést a következő újrapróbálkozásig. Az első paraméter az újrapróbálkozások száma, a második pedig a késés. A 3,10+7 például 3 kísérlet 10-től kezdve, és minden következő újrapróbálkozik 7 másodperccel. Ha a +7 nincs megadva, akkor az alábbi újrapróbálkozás exponenciálisan megduplázódik.
Lekérdezésegyezés: Megadja az egyeztetni kívánt lekérdezést. Ha nincs megadva semmi, akkor az minden lekérdezésre érvényes. A SELECT megadása a kiválasztással kezdődő összes lekérdezésre utal.
Ha a fenti három összetevőt kombinálja egy kapcsolati sztringben való használathoz, az a következő:
RetryExec={1000,2000:3,10+7:SELECT}
Ami a következőt jelentené: "Az 1000- és 2000-s hibák esetén a SELECT-szel kezdődő lekérdezésben. Próbálkozzon kétszer 10 másodperces kezdeti késleltetéssel, és adjon hozzá 7 másodpercet minden következő kísérlethez"
Examples
40501,40540:4,5
A 40501-ben és a 40540-ben észlelt hibák esetén próbálkozzon újra legfeljebb négyszer, 5 másodperces kezdeti késleltetéssel, és exponenciális duplával az egyes újrapróbálkozások között. Ez a szabály az összes lekérdezésre vonatkozik.
49919:2,10+:CREATE
A CREATE kezdetű lekérdezés 49919-re vonatkozó hibájáért próbálkozzon újra legfeljebb kétszer, kezdetben 10 másodperc, majd 20 másodperc után.
49918,40501,10928:5,10+5:SELECT c1
A SELECT c1-től kezdődő lekérdezéseken a 49918,40501 és 10928 hiba esetén próbálkozzon újra legfeljebb ötször, várjon 10 másodpercet az első újrapróbálkozásra, és növelje a várakozást 5 másodperccel.
A fenti három szabály együtt adható meg a kapcsolati sztringben az alábbiak szerint:
RetryExec={49918,40501,10928:5,10+5:SELECT c1;49919:2,10+:CREATE;40501,40540:4,5}
A legáttekintőbb (egyező) szabály a végén van elhelyezve, hogy a két konkrétabb szabály megfeleljen a lekérdezéseiknek.
Ügyfélbizonyítvány
Megadja a visszacsatolási kapcsolatokkal történő hitelesítéshez használandó tanúsítványt (csak Linux SQL Serveren érhető el). A lehetőségek a következők:
| Beállítás értéke | Description |
|---|---|
sha1:<hash_value> |
Az ODBC-illesztő SHA1 kivonat használatával keres tanúsítványt a Windows Tanúsítványtárolóban |
subject:<subject> |
Az ODBC-illesztő a Tanúsítványtárban való kereséshez használ egy tanúsítványt |
file:<file_location>[,password:<password>] |
Az ODBC-illesztő tanúsítványfájlt használ. |
Ha a tanúsítvány PFX formátumban van, és a PFX-tanúsítvány titkos kulcsa jelszóval védett, a jelszó kulcsszóra van szükség. PEM- és DER-formátumú tanúsítványok esetén a ClientKey attribútum szükséges
ClientKey
Megadja a ClientCertificate attribútum által megadott titkos kulcs PEM vagy DER tanúsítványok fájlhelyét. Formátum:
| Beállítás értéke | Description |
|---|---|
file:<file_location>[,password:<password>] |
Megadja a titkos kulcsfájl helyét. |
Ha a titkos kulcsfájl jelszóval védett, akkor jelszó kulcsszóra van szükség. Ha a jelszó bármilyen karaktert , tartalmaz, a rendszer minden egyes karakter után egy további , karaktert ad hozzá. Ha például a jelszó, a,b,cakkor a kapcsolati sztringben található megmenekült jelszó.a,,b,,c
HostnameInCertificate
Megadja a kiszolgáló tanúsítványában a titkosítás egyeztetésekor elvárandó állomásnevet, ha az eltér az Addr/Address/Server alapértelmezett értékétől. A HostnameInCertificate beállítás figyelmen kívül lesz hagyva a ServerCertificate beállítás használatakor.
IpAddressPreference
A 18.1-es verziótól kezdve elérhető beállítás lehetővé teszi a felhasználó számára, hogy megadja a kapcsolatokhoz rangsorolni kívánt IP-cím típusát. A lehetséges lehetőségek az "IpAddress= [ IPv4First | IPv6First | UsePlatformDefault]." A UsePlatformDefault a rendszerhívás által megadott sorrendben csatlakozik a címekhez a kiszolgáló nevének feloldásához. Az alapértelmezett érték az IPv4First, amely megfelel az előző verziók viselkedésének.
ServerCertificate
A 18.1-es verziótól kezdve elérhető beállítás szigorú titkosítási móddal is használható. A ServerCertificate kulcsszó az SQL Server TLS/SSL-tanúsítványsal egyező tanúsítványfájl elérési útját adja meg. Az egyezés a szabványos tanúsítványérvényesítés (lejárat, állomásnév, megbízhatósági lánc stb.) helyett történik. Az elfogadott tanúsítványformátumok a PEM, a DER és a CER. Ha meg van adva, az SQL Server-tanúsítványt úgy ellenőrzi a rendszer, hogy a megadott ServerCertificate pontos egyezés-e.
SQL_COPT_SS_ACCESS_TOKEN
Engedélyezi a Microsoft Entra hozzáférési jogkivonat használatát a hitelesítéshez. További információ: A Microsoft Entra ID használata.
| Attribútumérték | Description |
|---|---|
| NULLA | (Alapértelmezett) Nincs megadva hozzáférési jogkivonat. |
| ACCESSTOKEN* | Mutató egy hozzáférési jogkivonatra. |
SQL_COPT_SS_CEKEYSTOREDATA
Egy betöltött kulcstár szolgáltatói kódtárával kommunikál. Lásd: Vezérlők transzparens oszloptitkosítás (Always Encrypted). Ez az attribútum nem rendelkezik alapértelmezett értékkel. További információ: Egyéni kulcstár-szolgáltatók.
| Attribútumérték | Description |
|---|---|
| CEKEYSTOREDATA * | Kommunikációs adatstruktúra a kulcstár szolgáltatói kódtárához |
SQL_COPT_SS_CEKEYSTOREPROVIDER
Betölti az Always Encrypted kulcstár-szolgáltatói kódtárát, vagy lekéri a betöltött kulcstár-szolgáltatói kódtárak nevét. További információ: Egyéni kulcstár-szolgáltatók. Ez az attribútum nem rendelkezik alapértelmezett értékkel.
| Attribútumérték | Description |
|---|---|
| bejárónő* | Kulcstár-szolgáltatói kódtár elérési útja |
SQL_COPT_SS_ENLIST_IN_XA
Az XA-tranzakciók XA-kompatibilis tranzakciófeldolgozóval (TP) való engedélyezéséhez az alkalmazásnak meg kell hívnia az SQLSetConnectAttr-t SQL_COPT_SS_ENLIST_IN_XA és egy XACALLPARAM objektumra mutató mutatót. Ez a beállítás Windows (17.3+), Linux és macOS rendszeren támogatott.
SQLSetConnectAttr(hdbc, SQL_COPT_SS_ENLIST_IN_XA, param, SQL_IS_POINTER); // XACALLPARAM *param
Ha csak ODBC-kapcsolathoz szeretne társítani egy XA-tranzakciót, a híváskor SQLSetConnectAttraz egérmutató helyett az IGAZ vagy HAMIS értéket adja meg a SQL_COPT_SS_ENLIST_IN_XA. Ez a beállítás csak Windows rendszeren érvényes, és nem használható XA-műveletek ügyfélalkalmazáson keresztüli megadására.
SQLSetConnectAttr(hdbc, SQL_COPT_SS_ENLIST_IN_XA, (SQLPOINTER)TRUE, 0);
| Érték | Description | Platformok |
|---|---|---|
| XACALLPARAM objektum* | Az objektumra mutató XACALLPARAM mutató. |
Windows, Linux és macOS |
| TRUE | Az XA-tranzakció társítása az ODBC-kapcsolattal. Az összes kapcsolódó adatbázis-tevékenység az XA-tranzakció védelme alatt történik. | Windows |
| FALSE | A tranzakció társítása az ODBC-kapcsolattal. | Windows |
További információ az XA-tranzakciókról: XA-tranzakciók használata.
SQL_COPT_SS_LONGASMAX
Lehetővé teszi, hogy a hosszú típusú adatok maximális típusadatokként legyenek elküldve a kiszolgálóknak.
| Attribútumérték | Description |
|---|---|
| Nem | (Alapértelmezett) Küldéskor ne alakítsa át a hosszú típusokat maximális típussá. |
| Igen | A küldés során a hosszú típusból a maximális típusba konvertálja az adatokat. |
SQL_COPT_SS_SPID
Lekéri a kapcsolat munkamenet-azonosítóját. Ez a tulajdonság egyenértékű a T-SQL @@SPID változóval, azzal a különbséggel, hogy nem jár további oda-visszaút a kiszolgálóval.
| Attribútumérték | Description |
|---|---|
| DWORD | SPID |