Dela via

Anslutningsegenskaper som stöds

  • Artikel

Den här artikeln beskriver anslutningsegenskaperna som stöds av Databricks JDBC Driver (OSS).

autentiserings- och proxyegenskaper

Följande anslutningsegenskaper stöds av Databricks JDBC Driver (OSS). Egenskaperna är skiftlägesokänsliga.

Egenskap Standardvärde Beskrivning
AsyncExecPollInterval 200 Tiden i millisekunder mellan varje kontroll av status för asynkron frågeexekvering. Asynkront refererar till det faktum att RPC-anropet som används för att köra en fråga mot Spark är asynkront. Det betyder inte att JDBC-asynkrona åtgärder stöds.
Auth_Flow 0 OAuth2-autentiseringsflödet för drivrutinsanslutningen. Den här egenskapen krävs om AuthMech är 11.
Auth_JWT_Key_File null Sökvägen till den privata nyckelfilen (PEM-format) för JWT-autentisering.
Auth_JWT_Alg RS256 Algoritmen för JWT-autentisering med privat nyckel. De algoritmer som stöds är: RSA: RS256, RS384, RS512, PS256, PS384, PS512 och EC: ES256, ES384, ES512
Auth_JWT_Key_Passphrase null Lösenfrasen för dekryptering av en krypterad privat nyckel.
Auth_KID null Nyckelidentifieraren (KID) som krävs för JWT-autentisering. Detta är obligatoriskt när du använder JWT med privat nyckel.
AuthMech Krävs Autentiseringsmekanismen, där 3 anger att mekanismen är en personlig Åtkomsttoken för Azure Databricks, och 11 anger att mekanismen är OAuth 2.0-token. Ytterligare egenskaper krävs för varje mekanism. Se Autentisera föraren.
CFProxyAuth 0 Om inställningen är inställd på 1använder drivrutinen användaren och lösenordet för proxyautentisering, som representeras av CFProxyUID och CFProxyPwd.
CFProxyHost null En sträng som representerar namnet på proxyvärden som ska användas när UseCFProxy också är inställd på 1.
CFProxyPort null Ett heltal som representerar antalet proxyportar som ska användas när UseCFProxy är också inställt på 1.
CFProxyUID null En sträng som representerar användarnamnet som ska användas för proxyautentisering när CFProxyAuth och UseCFProxy är också inställda på 1.
CFProxyPwd null En sträng som representerar lösenordet som ska användas för proxyautentisering när CFProxyAuth och UseCFProxy är också inställda på 1.
ConnCatalog eller catalog SPARK Namnet på den standardkatalog som ska användas.
ConnSchema eller schema default Namnet på det standardschema som ska användas. Detta kan anges antingen genom att ersätta <schema> i URL:en med namnet på schemat som ska användas eller genom att ange egenskapen ConnSchema till namnet på schemat som ska användas.
EnableComplexDatatypeSupport 0 Om värdet är inställt på 1aktiveras stöd för komplexa datatyper (ARRAYs, STRUCTs, MAPs) som interna Java-objekt i stället för strängar.
GoogleServiceAccount null Aktiverar autentisering med ett Google-tjänstkonto.
GoogleCredentialsFile null Sökvägen till JSON-nyckelfilen för Google Service-kontoautentisering.
EnableOIDCDiscovery 1 Om värdet är 1används OpenID Connect-identifierings-URL:en.
OIDCDiscoveryEndpoint null OpenID Connect-upptäckts-URL:en för att hämta OIDC-konfigurationen.
Auth_RefreshToken null OAuth2-uppdateringstoken som används för att hämta en ny åtkomsttoken.
OAuth2ConnAuthAuthorizeEndpoint null Url:en för auktoriseringsslutpunkten som används i ett OAuth2-flöde.
OAuth2ConnAuthTokenEndpoint null URL:en för tokenslutpunkten för OAuth2-flödet.
ProxyAuth 0 Om inställningen är inställd på 1använder drivrutinen användaren och lösenordet för proxyautentisering, som representeras av ProxyUID och ProxyPwd.
ProxyHost null En sträng som representerar namnet på proxyvärden som ska användas när UseProxy också är inställd på 1.
ProxyPort null Ett heltal som representerar antalet proxyportar som ska användas när UseProxy är också inställt på 1.
ProxyPwd null En sträng som representerar lösenordet som ska användas för proxyautentisering när ProxyAuth och UseProxy är också inställda på 1.
ProxyUID null En sträng som representerar användarnamnet som ska användas för proxyautentisering när ProxyAuth och UseProxy är också inställda på 1.
SSL 1 Om anslutningen kommunicerar med Spark-servern via en SSL-ansluten socket.
UseProxy 0 Om inställningen är inställd på 1använder drivrutinen de angivna proxyinställningarna (till exempel: ProxyAuth, ProxyHost, ProxyPort, ProxyPwdoch ProxyUID).
UseSystemProxy 0 Om inställningen är inställd på 1använder drivrutinen de proxyinställningar som har angetts på systemnivå. Om ytterligare proxyegenskaper anges i anslutnings-URL:en åsidosätter dessa ytterligare proxyegenskaper de som har angetts på systemnivå.
UseCFProxy 0 Om inställningen är inställd på 1använder drivrutinen proxyinställningarna för molnhämtning om de tillhandahålls, annars använder du den vanliga proxyn.
UseJWTAssertion false Aktiverar JWT-autentisering med privat nyckel för M2M-användningsfall där klienthemlig autentisering är begränsad.
UserAgentEntry browser Posten User-Agent som ska inkluderas i HTTP-begäran. Det här värdet är i följande format: [ProductName]/[ProductVersion] [Comment]
UseThriftClient 0 Om JDBC-drivrutinen ska använda Thrift-klienten för att ansluta till ett kluster för alla syften. Standardvärdet fungerar för SQL-lager.

SQL-konfigurationsegenskaper

Följande SQL-konfigurationsegenskaper stöds av Databricks JDBC Driver (OSS). Dessa beskrivs också i Konfigurationsparametrar. Egenskaperna är skiftlägesokänsliga.

Egenskap Standardvärde Beskrivning
ansi_mode TRUE Om du vill aktivera strikt ANSI SQL-beteende för vissa funktioner och regler för gjutning.
enable_photon TRUE Om du vill aktivera den fotovektoriserade frågemotorn.
legacy_time_parser_policy EXCEPTION De metoder som används för att parsa och formatera datum och tidsstämplar. Giltiga värden är EXCEPTION, LEGACYoch CORRECTED.
max_file_partition_bytes 128m Det maximala antalet byte som ska packas i en enda partition när du läser från filbaserade källor. Inställningen kan vara ett positivt heltal och eventuellt inkludera ett mått som b (byte), k eller kb (1 024 byte).
read_only_external_metastore false Styr om ett externt metaarkiv behandlas som skrivskyddat.
statement_timeout 172800 Anger tidsgränsen för SQL-instruktionen mellan 0 och 172800 sekunder.
timezone UTC Ange den lokala tidszonen. Region-ID:n i formuläret area/city, till exempel Amerika/Los_Angeles eller zonförskjutningar i formatet (+|-)HH, (+|-)HH:mm eller (+|-)HH:mm:ss, t.ex. -08, +01:00 eller -13:33:33. Dessutom stöds UTC som ett alias för +00:00
use_cached_result true Om Databricks SQL cachelagrar och återanvänder resultat när det är möjligt.

loggningsegenskaper

Följande loggningsegenskaper stöds av Databricks JDBC Driver (OSS). Egenskaperna är skiftlägesokänsliga.

Egenskap Standardvärde Beskrivning
LogLevel OFF Loggningsnivån, som är värdet 0 till 6:
  • 0: Inaktivera all loggning.
  • 1: Aktivera loggning på FATAL-nivån, som loggar mycket allvarliga felhändelser som kommer att leda till att anslutningen avbryts.
  • 2: Aktivera loggning på felnivån, som loggar felhändelser som fortfarande kan tillåta att anslutningsappen fortsätter att köras.
  • 3: Aktivera loggning på VARNING-nivån, som loggar händelser som kan resultera i ett fel om åtgärden inte vidtas.
  • 4: Aktivera loggning på INFO-nivån, som loggar allmän information som beskriver förloppet för anslutningen.
  • 5: Aktivera loggning på FELSÖKNINGsnivå, som loggar detaljerad information som är användbar för felsökning av anslutningsappen.
  • 6: Aktivera loggning på TRACE-nivån, som loggar all anslutningsaktivitet.

Använd den här egenskapen för att aktivera eller inaktivera loggning i anslutningsappen och för att ange hur mycket information som ingår i loggfilerna.
LogPath För att fastställa standardsökvägen för loggar använder drivrutinen värdet som angetts för dessa systemegenskaper i den här prioritetsordningen:
  • user.dir
  • java.io.tmpdir
  • den aktuella katalogen, med andra ord .
 Den fullständiga sökvägen till mappen där anslutningsappen sparar loggfiler när loggning är aktiverad, som en sträng. För att säkerställa att anslutnings-URL:en är kompatibel med alla JDBC-program kan du undvika omvänt snedstreck (\) i filsökvägen genom att skriva ett annat omvänt snedstreck.
Om värdet LogPath är ogiltigt skickar kontakten den loggade informationen till standardutdataströmmen (System.out).
LogFileSize Inget maxvärde Den maximala tillåtna loggfilsstorleken som anges i MB
LogFileCount Inget maxvärde Maximalt antal tillåtna loggfiler

Aktivera och konfigurera loggning

JDBC-drivrutinen stöder Simple Logging Facade for Java (SLF4J) och java.util.logging (JUL) ramverk. Drivrutinen använder JUL-loggningsramverket som standard.

Så här aktiverar och konfigurerar du loggning för JDBC-drivrutinen:

  1. Aktivera det loggningsramverk som du vill använda:

    • För SLF4J-loggning anger du systemegenskapen -Dcom.databricks.jdbc.loggerImpl=SLF4JLOGGER och tillhandahåller SLF4J-bindningsimplementeringen (kompatibel med SLF4J version 2.0.13 och senare) och motsvarande konfigurationsfil i klassökvägen.
    • För JUL-loggning anger du systemegenskapen -Dcom.databricks.jdbc.loggerImpl=JDKLOGGER. Det här är standardinställningen.

  2. Ange egenskapen LogLevel på anslutningssträngen till önskad informationsnivå som ska inkluderas i loggfilerna.

  3. Ange egenskapen LogPath i anslutningssträngen till den fullständiga sökvägen till mappen där du vill spara loggfiler.

    Följande anslutnings-URL aktiverar till exempel loggningsnivå 6 och sparar loggfilerna i mappen C:temp:

    jdbc: databricks://localhost:11000;LogLevel=6;LogPath=C:\\temp

  4. Starta om JDBC-programmet och återanslut till servern för att tillämpa inställningarna.

egenskaper för volymoperationer

Följande egenskaper för Unity Catalog-volymåtgärder stöds av Databricks JDBC Driver (OSS). Egenskaperna är skiftlägesokänsliga.

Egenskap Standardvärde Beskrivning
VolumeOperationAllowedLocalPaths `` Kommaavgränsad lista över tillåtna lokala sökvägar för nedladdning och uppladdning av UC-volyminmatningsfiler. Sökvägarna omfattar även underkataloger.

Hantera filer med hjälp av volymer

Databricks erbjuder funktioner för massinmatning (ladda upp/ladda ned/ta bort) med hjälp av Unity Catalog-volymer, så att användare kan överföra datamängder till och från lokala filer som CSV-filer. Se Vad är Unity Catalog-volymer?. Om du vill aktivera volymåtgärder i Unity Catalog anger du anslutningsegenskapen VolumeOperationAllowedLocalPaths till en kommaavgränsad lista över tillåtna lokala sökvägar för volymåtgärderna.

Unity Catalog måste vara aktiverat för att kunna använda den här funktionen. Liknande funktioner är tillgängliga med hjälp av Databricks-användargränssnittet. Se Ladda upp filer till en Unity Catalog-volym.

Enhetskatalogens inmatningskommandon är SQL-instruktioner. Exemplen nedan visar put-, GET- och REMOVE-åtgärder.

Ladda upp en lokal fil

Om du vill ladda upp en lokal fil /tmp/test.csv till en Volymsökväg för Unity Catalog som /Volumes/main/default/e2etests/file1.csvanvänder du PUT-åtgärden:

  PUT '/tmp/test.csv' INTO '/Volumes/main/default/e2etests/file1.csv' OVERWRITE

Ladda ned en fil

Om du vill ladda ned en fil från volymsökvägen i Unity Catalog /Volumes/main/default/e2etests/file1.csv till en lokal fil /tmp/test.csvanvänder du åtgärden GET:

  GET '/Volumes/main/default/e2etests/file1.csv' TO '/tmp/test.csv'

Ta bort en fil

Om du vill ta bort en fil med en Unity Catalog-volymsökväg /Volumes/main/default/e2etests/file1.csvanvänder du åtgärden REMOVE:

  REMOVE '/Volumes/main/default/e2etests/file1.csv'