Desteklenen bağlantı özellikleri

Bu makalede Databricks JDBC Sürücüsü, sürüm 3 ve üzeri tarafından desteklenen bağlantı özellikleri açıklanmaktadır.

Kimlik Doğrulama ve Ara Sunucu Özellikleri

Aşağıdaki kimlik doğrulaması ve proxy özellikleri Databricks JDBC Sürücüsü tarafından desteklenir. Özellikler büyük/küçük harfe duyarlı değildir.

Mülkiyet	Varsayılan değer	Açıklama
`AsyncExecPollInterval`	`200`	Her bir yoklama arasındaki zaman, milisaniye cinsinden, uyumsuz sorgu yürütme durumu için belirlenmiştir. Asenkron terimi, Spark üzerinde bir sorgu yürütmek için kullanılan RPC çağrısının asenkron olduğunu ifade eder. Bu, JDBC zaman uyumsuz işlemlerinin desteklendiği anlamına gelmez.
`Auth_Flow`	`0`	Sürücü bağlantısı için OAuth2 kimlik doğrulama akışı. `AuthMech` `11`ise bu özellik gereklidir.
`Auth_JWT_Alg`	`RS256`	Özel anahtar JWT kimlik doğrulaması algoritması. Desteklenen algoritmalar şunlardır: RSA: RS256, RS384, RS512, PS256, PS384, PS512 ve EC: ES256, ES384, ES512
`Auth_JWT_Key_File`	`null`	JWT kimlik doğrulaması için özel anahtar dosyasının (PEM biçimi) yolu.
`Auth_JWT_Key_Passphrase`	`null`	Şifrelenmiş bir özel anahtarın şifresini çözmek için kullanılan parola.
`Auth_KID`	`null`	JWT kimlik doğrulaması için gereken Anahtar Tanımlayıcısı (KID). Özel anahtar JWT kullanılırken bu zorunludur.
`Auth_RefreshToken`	`null`	Yeni erişim belirtecini almak için kullanılan OAuth2 yenileme belirteci.
`Auth_Scope`	`all-apis`	OAuth2 akışları için kimlik doğrulama kapsamı.
`AuthMech`	Gerekli	Kimlik doğrulama mekanizmasında, `3` mekanizmanın Azure Databricks kişisel erişim belirteci olduğunu, `11` ise mekanizmanın OAuth 2.0 belirteçleri olduğunu belirtir. Her mekanizma için ek özellikler gereklidir. Bkz. sürücünün kimliğini doğrulama.
`AzureTenantId`	`null`	Azure'a özgü kimlik doğrulaması için Azure kiracı kimliği.
`CFProxyAuth`	`0`	`1`olarak ayarlanırsa, sürücü `CFProxyUID` ve `CFProxyPwd`ile temsil edilen proxy kimlik doğrulama kullanıcısını ve parolasını kullanır.
`CFProxyHost`	`null`	`UseCFProxy` de `1`olarak ayarlandığında kullanılacak ara sunucu konağı adını temsil eden bir dize.
`CFProxyPort`	`null`	`UseCFProxy` de `1`olarak ayarlandığında kullanılacak ara sunucu bağlantı noktasının sayısını temsil eden bir tamsayı.
`CFProxyPwd`	`null`	`CFProxyAuth` ve `UseCFProxy` da `1`olarak ayarlandığında proxy kimlik doğrulaması için kullanılacak parolayı temsil eden bir dize.
`CFProxyUID`	`null`	`CFProxyAuth` ve `UseCFProxy` de `1`olarak ayarlandığında proxy kimlik doğrulaması için kullanılacak kullanıcı adını temsil eden bir dize.
`ConnCatalog` veya `catalog`	`SPARK`	Kullanılacak varsayılan kataloğun adı.
`ConnSchema` veya `schema`	`default`	Kullanılacak varsayılan şemanın adı. Bu, URL'deki `<schema>` kullanılacak şemanın adıyla değiştirilerek veya `ConnSchema` özelliği kullanılacak şemanın adı olarak ayarlanarak belirtilebilir.
`EnableOIDCDiscovery`	`1`	`1`olarak ayarlanırsa OpenID Connect bulma URL'si kullanılır.
`EnableTokenCache`	`1`	olarak ayarlanırsa `1`, performansı artırmak için OAuth belirteçlerinin önbelleğe alınmasını etkinleştirir.
`GoogleCredentialsFile`	`null`	Google Service hesabı kimlik doğrulaması için JSON anahtar dosyasının yolu.
`GoogleServiceAccount`	`null`	Google hizmet hesabı kullanarak kimlik doğrulamasını etkinleştirir.
`OAuth2ClientId`	`null`	Kimlik doğrulaması için OAuth2 istemci kimliği. Varsayılan olarak AWS, `databricks-sql-jdbc` GCP ve Azure için kullanılır. Gelişmiş OAuth yapılandırmaları için özel bir istemci kimliği gereklidir.
`OAuth2ConnAuthAuthorizeEndpoint`	`null`	OAuth2 akışında kullanılan yetkilendirme uç noktası URL'si.
`OAuth2ConnAuthTokenEndpoint`	`null`	OAuth2 akışı için belirteç uç noktası URL'si.
`OAuth2RedirectUrlPort`	`8020`	Tarayıcı tabanlı kimlik doğrulama akışları için OAuth2 URL'si yeniden yönlendirme bağlantı noktası.
`OIDCDiscoveryEndpoint`	`null`	OIDC yapılandırmasını almak için OpenID Connect keşif URL'si.
`ProxyAuth`	`0`	`1`olarak ayarlanırsa, sürücü `ProxyUID` ve `ProxyPwd`ile temsil edilen proxy kimlik doğrulama kullanıcısını ve parolasını kullanır.
`ProxyHost`	`null`	`UseProxy` de `1`olarak ayarlandığında kullanılacak ara sunucu konağı adını temsil eden bir dize.
`ProxyPort`	`null`	`UseProxy` de `1`olarak ayarlandığında kullanılacak ara sunucu bağlantı noktasının sayısını temsil eden bir tamsayı.
`ProxyPwd`	`null`	`ProxyAuth` ve `UseProxy` da `1`olarak ayarlandığında proxy kimlik doğrulaması için kullanılacak parolayı temsil eden bir dize.
`ProxyUID`	`null`	`ProxyAuth` ve `UseProxy` de `1`olarak ayarlandığında proxy kimlik doğrulaması için kullanılacak kullanıcı adını temsil eden bir dize.
`TokenCachePassPhrase`	`null`	OAuth U2M belirteç önbelleği şifrelemesi için kullanılacak parola.
`UseCFProxy`	`0`	`1`olarak ayarlandığında, sürücü bulut getirme proxy ayarları sağlanmışsa onları kullanır, aksi takdirde normal ara sunucuyu kullanır.
`UseJWTAssertion`	`false`	İstemci gizli anahtarı kimlik doğrulamasının kısıtlandığı M2M kullanım örnekleri için özel anahtar JWT kimlik doğrulamasını etkinleştirir.
`UseProxy`	`0`	`1`olarak ayarlanırsa, sürücü sağlanan ara sunucu ayarlarını kullanır (örneğin: `ProxyAuth`, `ProxyHost`, `ProxyPort`, `ProxyPwd`ve `ProxyUID`).
`UseSystemProxy`	`0`	`1`olarak ayarlanırsa, sürücü sistem düzeyinde ayarlanmış ara sunucu ayarlarını kullanır. Bağlantı URL'sinde başka ara sunucu özellikleri ayarlanırsa, bu ek ara sunucu özellikleri sistem düzeyinde ayarlanmış olanları geçersiz kılar.

SSL güven deposu yapılandırma özellikleri

Aşağıdaki SSL güven deposu yapılandırma özellikleri Databricks JDBC Sürücüsü tarafından desteklenir. Özellikler büyük/küçük harfe duyarlı değildir.

Mülkiyet	Varsayılan değer	Açıklama
`AcceptUndeterminedRevocation`	`0`	olarak `1`ayarlanırsa, sertifika iptal denetimi etkinleştirildiğinde, iptal durumu belirsiz olan sertifikaları kabul eder.
`AllowSelfSignedCerts`	`0`	olarak ayarlanırsa `1`, sürücü otomatik olarak imzalanan SSL sertifikalarına sahip sunuculara bağlantılara izin verir.
`CheckCertificateRevocation`	`0`	olarak ayarlanırsa `1`, sürücü SSL sertifikasının iptal edilip edilmediğini denetler.
`SSL`	`1`	Bağlayıcının SSL özellikli bir yuva üzerinden Spark sunucusuyla iletişim kurup kurmadığı.
`SSLKeyStore`	`null`	İstemci sertifikası kimlik doğrulaması için SSL anahtar deposu dosyasının yolu. Varsayılan olarak, istemci sertifikası gerekmemesi için yalnızca sunucu TLS kimlik doğrulaması gerçekleştirilir.
`SSLKeyStorePwd`	`null`	SSL anahtar deposu dosyasının parolası.
`SSLKeyStoreType`	`JKS`	SSL anahtar deposunun türü. Geçerli değerler , , `JKSPKCS12JCEKS`ve `DKS`değerleridir.`PKCS11`
`SSLTrustStore`	`null`	SSL sertifika doğrulaması için güven deposu dosyasının yolu.
`SSLTrustStorePassword`	`null`	Güven deposu dosyasının parolası, eğer parola korumalıysa.
`SSLTrustStoreType`	`JKS`	Güven deposu türü, örneğin JKS veya PKCS12. Belirtilmediği takdirde, sürücü JKS güvenlik deposunu varsayılan olarak kullanır. Geçerli türler : `JKS`, `PKCS12`ve `BCFKS`.
`UseSystemTrustStore`	`0`	olarak ayarlanırsa `1`, sürücü SSL sertifika doğrulaması için sistemin varsayılan güven depounu kullanır.

Güven deposu türleri

JDBC sürücüsü aşağıdaki SSL modlarını ve güven deposu türlerini destekler.

Otomatik olarak imzalanan sertifika modu

Otomatik olarak imzalanan sertifika modunu kullanmak için bağlantı özelliğini AllowSelfSignedCerts=1ayarlayın. Bu mod, tüm sertifikaları kabul eden bir yuva fabrikası kullanır.

Özel güven deposu

Özel güven deposu kullanmak için bağlantı özelliğinde SSLTrustStore bir özel güven deposu dosyası belirtin. Bu güven deposu doğrudan belirtilen yoldan yüklenir ve SSL sertifika doğrulaması için sertifikaları kullanır. JKS, PKCS12 veya desteklenen diğer biçimlerde olabilir.

Aşağıdaki ek bağlantı özelliklerini belirtmelisiniz:

SSLTrustStore: Güven deposu dosyasının yolu
SSLTrustStorePassword: Güven deposunun parolası (gerekirse)
SSLTrustStoreType: Güven deposunun türü (isteğe bağlı, belirtilmezse varsayılan olarak JKS olur)

Java sistem özelliği güven deposu

Sistem özelliği güven deposunu kullanmak için UseSystemTrustStore=1 ayarlayın ve özel bir güven deposu belirtmediğinizden emin olun. Bunun yerine, Java sistem özelliğini javax.net.ssl.trustStorekullanarak bir güven deposu belirtin. Bu özellik JVM düzeyinde bayrağı kullanılarak -D ayarlanır, örneğin:

java -Djavax.net.ssl.trustStore=/path/to/truststore.jks -Djavax.net.ssl.trustStorePassword=changeit ...

JDBC sürücüsü önce Java sistem özelliğini javax.net.ssl.trustStoredenetler. Ayarlanırsa, JDK'nin varsayılanı yerine bu güven deposu dosyasını kullanır. Hiçbir sistem özelliği ayarlanmamışsa, JDK'nin varsayılan güven deposunu (cacerts), $JAVA_HOME/lib/security/cacerts veya benzeri bir yolda bulunanı kullanır.

JDK varsayılan güven deposu (sertifikalar)

JDK, cacerts adlı yerleşik bir güven deposuyla birlikte gelir ve bu depo, bu CA'lar tarafından verilen sertifikaların doğrulanmasına olanak tanıyan iyi bilinen Sertifika Yetkililerinin sertifikalarını içerir. Bu güven deposu genellikle $JAVA_HOME/lib/security/cacerts konumunda ve varsayılan parola "changeit" veya "changeme" ile yer alır.

JDK varsayılan güven deposunu kullanmak için UseSystemTrustStore=1 öğesini ayarlayın ve özel bir güven deposu veya Java sistem özelliği güven deposu belirtmediğinizden emin olun. Bir güven deposu da Java sistem özelliği javax.net.ssl.trustStore kullanılarak belirtilirse, bu özellik göz ardı edilir, bu da sürücünün yalnızca varsayılan JDK güven deposundaki sertifikaları kullanmasını sağlar.

Güven deposu öncelik sırası

Sürücü, hangi güven deposunun kullanılacağını belirlemek için aşağıdaki öncelik sırasını kullanır:

Bağlantı özelliğinde SSLTrustStore belirtilen özel güven deposu
Java sistem özelliğinde javax.net.ssl.trustStore belirtilen güven deposu (UseSystemTrustStore=1 olduğunda)
JDK'nin varsayılan güven deposu (sertifikalar)

Güvenlik önerileri

Bağlantınızı güvenli tutmak için Databricks aşağıdakileri önerir:

Üretim ortamları için:
- Otomatik olarak imzalanan sertifika modunu (AllowSelfSignedCerts=1 ) kullanmayın.
- Ca ile imzalanan resmi sertifikaları kullanın.
- Özel bir güven deposuna ihtiyacınız olmadığı sürece kullanın UseSystemTrustStore=1 .
Özel güven depoları için:
- Varsayılan güven deposunda olmayan sertifikalara sahip sunuculara bağlanırken kullanın.
- Güven deposunun tüm sertifika zincirini içerdiğinden emin olun.
- Güven deposu dosyalarını uygun izinlerle koruyun.

Strateji özelliklerini yeniden deneme

Aşağıdaki yeniden deneme stratejisi özellikleri Databricks JDBC Sürücüsü (OSS) tarafından desteklenir. Özellikler büyük/küçük harfe duyarlı değildir.

Mülkiyet	Varsayılan değer	Açıklama
`RateLimitRetry`	`1`	olarak ayarlanırsa `1`, hız sınırı hatalarında yeniden denemeyi etkinleştirir.
`RateLimitRetryTimeout`	`120`	Yeniden deneme zaman aşımlarını saniye cinsinden ayarlayın.
`TemporarilyUnavailableRetry`	`1`	`1` olarak ayarlanırsa, geçici olarak kullanılamayan hatalarda yeniden denemeyi etkinleştirir.
`TemporarilyUnavailableRetryTimeout`	`900`	Geçici olarak kullanılamayan hatalar için saniye cinsinden yeniden deneme zaman aşımı süresi.
`VolumeOperationRetryableHttpCode`	`408,429,500,502,503,504`	Birlikte Katalog hacim alımı için tekrar denenebilir HTTP kodlarının virgülle ayrılmış listesi.
`VolumeOperationRetryTimeout`	`15`	Unity Kataloğu hacim alımı HTTP istekleri için dakikalar cinsinden yeniden deneme zaman aşımı süresi.

Performans ve bağlantı yönetimi özellikleri

Aşağıdaki performans ve bağlantı yönetimi özellikleri Databricks JDBC Sürücüsü (OSS) tarafından desteklenir. Özellikler büyük/küçük harfe duyarlı değildir.

Mülkiyet	Varsayılan değer	Açıklama
`CloudFetchThreadPoolSize`	`16`	Bulut getirme işlemleri için iş parçacığı havuzu boyutu.
`DefaultStringColumnLength`	`255`	Meta veri raporlama için STRING sütunlarında bulunabilecek karakter sayısı üst sınırı.
`HttpConnectionPoolSize`	`100`	En büyük HTTP bağlantı havuzu boyutu.
`IdleHttpConnectionExpiry`	`60`	Boştaki HTTP bağlantısının süre sonu süresi (saniye olarak).
`RowsFetchedPerBlock`	`2000000`	Bir sorgunun bir kerede döndürdüğü en fazla satır sayısı. Bu yalnızca satır içi sonuçlar için geçerlidir.
`SocketTimeout`	`900`	Ağ işlemleri için soket zaman aşımı süresi, saniye cinsinden.

SQL yapılandırma özellikleri

Aşağıdaki SQL yapılandırma özellikleri Databricks JDBC Sürücüsü tarafından desteklenir. Bunlar,Yapılandırma parametreleri bölümünde de açıklanmıştır. Özellikler büyük/küçük harfe duyarlı değildir.

Mülkiyet	Varsayılan değer	Açıklama
`ansi_mode`	`TRUE`	Belirli işlevler ve atama kuralları için katı ANSI SQL davranışının etkinleştirilip etkinleştirilmeyileceği.
`enable_photon`	`TRUE`	Photon vektörleştirilmiş sorgu altyapısının etkinleştirilip etkinleştirilmeyileceği.
`legacy_time_parser_policy`	`EXCEPTION`	Tarihleri ve zaman damgalarını ayrıştırmak ve biçimlendirmek için kullanılan yöntemler. Geçerli değerler `EXCEPTION`, `LEGACY`ve `CORRECTED`.
`max_file_partition_bytes`	`128m`	Dosya tabanlı kaynaklardan okurken tek bir bölüme paketlenmesi gereken bayt sayısı üst sınırı. Bu ayar herhangi bir pozitif tamsayı olabilir ve isteğe bağlı olarak `b` (bayt), `k` veya `kb` (1024 bayt) gibi bir ölçü içerebilir.
`query_tags`	`""` (boş dize)	`system.query.history` içinde izleme ve analiz amacıyla SQL sorgularına eklenecek anahtar-değer etiketlerinin virgülle ayrılmış listesi.
`read_only_external_metastore`	`false`	Dış meta veri deposunun salt okunur olarak işlenip işlenmediğini denetler.
`statement_timeout`	`172800`	0 ile 172800 saniye arasında bir SQL deyimi için zaman aşımı ayarlar.
`timezone`	`UTC`	Yerel saat dilimini ayarlayın. Bölge Kimlikleri, `area/city`biçiminde, Amerika/Los_Angeles gibi veya bölge uzaklıkları +\|-)HH, (+\|-)HH:mm veya (+\|-)HH:mm:ss formatlarında, örneğin -08, +01:00 veya -13:33:33. Ayrıca, `UTC` +00:00 için diğer ad olarak desteklenir
`use_cached_result`	`true`	Databricks SQL'in mümkün olduğunca sonuçları önbelleğe alıp almadığı ve yeniden kullanıp kullanmadığı.

Günlük özellikleri

Aşağıda listelenen günlükleme özellikleri Databricks JDBC Sürücüsü tarafından desteklenir. Özellikler büyük/küçük harfe duyarlı değildir.

Mülkiyet	Varsayılan değer	Açıklama
`LogFileCount`	`10`	İzin verilen log dosyalarının en fazla sayısı
`LogFileSize`	`10`	MB cinsinden belirtilen izin verilen maksimum günlük dosyası boyutu
`LogLevel`	`OFF`	0'dan 6'ya kadar bir değer olan günlük düzeyi: 0: Tüm günlükleri devre dışı bırakın. 1: Bağlayıcıyı durduracak kadar ciddi hata olaylarını günlüğe kaydeden FATAL seviyesinde günlüğe kaydetmeyi etkinleştirin. 2: Hata düzeyinde günlüğe kaydı etkinleştirerek, bağlayıcının çalışmaya devam edebilmesini sağlayabilecek hata olaylarını kaydedin. 3: Eylem yapılmazsa hataya neden olabilecek olayları günlüğe UYARI düzeyinde kaydetmeyi etkinleştirin. 4: Bağlayıcının ilerlemesini açıklayan genel bilgileri kaydetmek için BİLGİ düzeyinde günlük kaydını etkinleştirin. 5: Bağlayıcıda hata ayıklama için yararlı olan ayrıntılı bilgileri günlüğe alan DEBUG düzeyinde günlüğe kaydetmeyi etkinleştirin. 6: TRACE düzeyinde, tüm bağlayıcı etkinliğini günlüğe kaydedecek şekilde kaydetmeyi etkinleştirin. Bağlayıcıda günlüğe kaydetmeyi etkinleştirmek veya devre dışı bırakmak ve günlük dosyalarına dahil edilen ayrıntı miktarını belirtmek için bu özelliği kullanın.
`LogPath`	Sürücü, günlüklerin varsayılan yolunu belirlemek için bu sistem özellikleri için ayarlanan değeri şu öncelik sırasına göre kullanır: `user.dir` `java.io.tmpdir` geçerli dizin, başka bir deyişle `.`	Günlük kaydı etkinleştirildiğinde, bağlayıcının günlük dosyalarını kaydettiği klasörün tam yolu bir dize olarak verilmiştir. Bağlantı URL'sinin tüm JDBC uygulamalarıyla uyumlu olduğundan emin olmak için, başka bir ters eğik çizgi yazarak dosya yolunuzda ters eğik çizgilerden (`\`) çıkın. `LogPath` değeri geçersizse, bağlayıcı günlüğe kaydedilen bilgileri standart çıkış akışına (System.out) gönderir.

Kayıt tutmayı etkinleştirme ve yapılandırma

JDBC sürücüsü Java için Basit Günlükleme Arabirimi (SLF4J) ve java.util.logging (JUL) çerçevelerini destekler. Sürücü varsayılan olarak JUL günlük çerçevesini kullanır.

JDBC sürücüsü için günlük kaydını etkinleştirmek ve yapılandırmak için:

Kullanmak istediğiniz kayıt framework'ünü etkinleştirin.
- SLF4J günlüğü için sistem özelliğini -Dcom.databricks.jdbc.loggerImpl=SLF4JLOGGER ayarlayın ve sınıf yolu içinde SLF4J bağlama uygulamasını (SLF4J sürüm 2.0.13 ve üzeri ile uyumlu) ve ilgili yapılandırma dosyasını sağlayın.
- JUL günlüğü için sistem özelliğini -Dcom.databricks.jdbc.loggerImpl=JDKLOGGER ayarlayın. Varsayılan değer budur.
Bağlantı dizesindeki LogLevel özelliğini günlük dosyalarına eklenecek istenen bilgi düzeyine ayarlayın.
Bağlantı dizesinde LogPath özelliğini günlük dosyalarını kaydetmek istediğiniz klasörün tam yoluna ayarlayın.

Örneğin, aşağıdaki bağlantı URL'si günlük düzeyi 6'yı etkinleştirir ve günlük dosyalarını C:\temp klasörüne kaydeder:
```
jdbc: databricks://localhost:11000;LogLevel=6;LogPath=C:\\temp
```
JDBC uygulamanızı yeniden başlatın ve ayarları uygulamak için sunucuya yeniden bağlanın.

Diğer özellik özellikleri

Aşağıdaki özellikler Databricks JDBC Sürücüsündeki özellikleri etkinleştirir. Özellikler büyük/küçük harfe duyarlı değildir.

Mülkiyet	Varsayılan değer	Açıklama
`EnableArrow`	`1`	`0` olarak ayarlanırsa, sonuçlar için Ok Serileştirme devre dışı bırakılır ve bu, Cloud Fetch için Ok biçimi gerektiğinden Cloud Fetch davranışını da devre dışı bırakır.
`EnableComplexDatatypeSupport`	`0`	`1`olarak ayarlanırsa, dizeler yerine yerel Java nesneleri olarak karmaşık veri türleri (ARRAY'ler, STRUCT'ler, MAP'ler) desteği etkinleştirilir.
`EnableDirectResults`	`1`	olarak `1`ayarlanırsa, gelişmiş sorgu performansı için doğrudan sonuçları etkinleştirir.
`EnableGeoSpatialSupport`	`0`	Eğer `1` olarak ayarlanırsa, yapılandırılmış Java nesneleri olarak jeo-uzamsal veri türleri (GEOMETRY ve GEOGRAPHY) için destek sağlar. `EnableComplexDatatypeSupport=1` ve `EnableArrow=1` gerektirir (Ok varsayılan olarak etkindir). Devre dışı bırakıldığında, coğrafi sütunlar dize olarak EWKT biçiminde döndürülür. Bkz. ST jeo-uzamsal işlevleri.
`EnableSqlScripting`	`1` veya `true`	SQL betik desteğini bileşik deyim blokları (BEGIN... END) ve saklı yordam çağrıları için etkinleştirir. Sürücü sürüm 1.0.10 ve üzeri ile Databricks Runtime 16.3 ve üzeri sürümlerde kullanılabilir. Saklı yordamlar Databricks Runtime 17.0 ve üzerini ve 3.0.1 ve üzeri bir sürücü sürümünü gerektirir. Yordamları çağırmak için `Statement` veya `PreparedStatement` kullanın. `CallableStatement` desteklenmez. Söz dizimi ve örnekler için bkz. SQL betiği oluşturma.
`EnableMetricViewMetadata`	`0`	olarak `1`ayarlanırsa, ölçüm görünümleri için gelişmiş meta veri işlemlerini etkinleştirir. Bkz. Databricks JDBC Sürücüsünü kullanarak ölçüm görünümü meta verileriyle çalışma.
`EnableTelemetry`	`0`	olarak ayarlanırsa `1`telemetri etkinleştirilir. Bkz . Telemetri.
`EnableVolumeOperations`	`1`veya `true`	Bir akışta birim işlemlerini etkinleştirmek için istemci bilgisi özelliği. Bkz. Databricks JDBC Sürücüsü ile birimlerdeki dosyaları yönetme. Varsayılan olarak, bu özellik REMOVE işlemini bir birim üzerinde de etkinleştirir. Önemli: Bunu bir istemci bilgisi özelliği olarak ayarlamanız gerekir. Bunu yalnızca bağlantı URL'sinde sağlamak, bir akış için birim işlemlerini etkinleştirmez.
`MaxBatchSize`	`500`	Toplu işlemler ve veri işleme için en büyük toplu iş boyutu.
`QueryResultCompressionType`	1	Geçerli değerler 0 (sıkıştırma olmadan) ve 1 (LZ4 sıkıştırması için) değerleridir. Sürücü, yapılandırılan ayardan bağımsız olarak satır içi sonuçlar için otomatik olarak 0 (sıkıştırma yok) olarak geçersiz kılar
`UserAgentEntry`	`browser`	HTTP isteğine eklenecek User-Agent girdisi. Bu değer şu biçimdedir: `[ProductName]/[ProductVersion] [Comment]`
`UseThriftClient`	`1`	JDBC sürücüsünün Thrift istemcisini mi yoksa Deyim Yürütme API'lerini mi kullanması gerektiği.
`VolumeOperationAllowedLocalPaths`	``	Unity Catalog birim alım dosyalarını indirmek ve yüklemek için izin verilen yerel adreslerin virgülle ayrılmış listesi. Dizin yolları alt dizinleri de içerir. Belirtilmediğinde, bu değeri `StagingAllowedLocalPaths`değerine geri döner ve ardından hiçbir kısıtlama belirtmeyen boş bir dizeye döner. Bkz. Birimleri kullanarak dosyaları yönetme. Önemli: Kurulum çok kiracılı bir ortamdaysa (BI araçları veya geliştirici hizmetleri gibi) ve kullanıcılar tam JDBC URL'sini denetlerse, hizmetin bu özelliği bir korumalı alan konumuna veya var olmayan bir yola ayarlaması gerekir. Bu, kullanıcıların rastgele dosyalar yazmasını ve hizmetin iç dağıtımına müdahale etmesini önler.

Telemetri koleksiyonu

Telemetri, Databricks'in hata ayıklamayı kolaylaştırıp şunları toplayarak zamanında sorun giderme sağlamasına olanak tanır:

İstemci ortamı ayrıntıları (sürücü sürümü, çalışma zamanı, işletim sistemi ayrıntıları)
JDBC bağlantı yapılandırmaları (tüm PII verilerini hariç tutar)
İşlem gecikmesi ölçümleri
Yürütme sonucu biçimi (satır içi JSON, Ok vb.)
İşlem türleri (yürütme sorgusu, meta veri sorgusu, birim işlemleri)
Hata sınıflandırma verileri
Yeniden deneme sayıları

Uyarı

Databricks, sorgu içeriğinin, sonuçlarının veya kişisel bilgilerin (PII) toplanmamasını sağlayan katı gizlilik standartlarına sahiptir.

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?

Last updated on 2025-12-15