JavaScript için Databricks SDK'ları

JavaScript için Databricks SDK'ları ile Azure Databricks işlemlerini otomatikleştirin ve geliştirmeyi hızlandırın. Bu SDK'lar Databricks REST API için yazılan istemciler sağlar. Her API için ayrı bir npm paketi içeren modüler bir mimariye sahiptir (örneğin, @databricks/sdk-postgres). Yalnızca kullandığınız API'lerin paketlerini yükleyin.

Bu sayfa, Databricks JavaScript SDK'lerine ait README ve örnekler için tamamlayıcı niteliktedir.

Requirements

JavaScript için Databricks SDK'larını kullanmak için geliştirme makinenizde aşağıdakiler olmalıdır:

• Node.js ve npm yüklü.
• Azure Databricks kimlik doğrulaması yapılandırıldı.

Başlayın

1. İhtiyacınız olan her API için paketi yükleyin. Her Databricks API'si adlı @databricks/sdk-<api>ayrı bir paket olarak yayımlanır. Örneğin, Postgres ile çalışmak için Node.js projenizin kökünden aşağıdaki komutu çalıştırın:

   npm install @databricks/sdk-postgres
   

2. Henüz yapılandırılmamışsa geliştirme makinenizi Azure Databricks kimlik doğrulaması için ayarlayın.

3. İstemciyi paketin sürümlü alt yolundan içe aktarın ve ardından API'yi çağırın. Aşağıdaki TypeScript örneği, Kimlik Doğrulaması bölümünde açıklanan varsayılan kimlik doğrulamasını kullanarak Postgres projelerinizi listeler. Liste yöntemleri, siz üzerinde yineleme yaptıkça sonuçları şeffaf bir şekilde sayfalayan bir Iter varyantı sunar:

   import { PostgresClient } from '@databricks/sdk-postgres/v1';
   
   const client = new PostgresClient({});
   
   for await (const project of client.listProjectsIter({})) {
     console.log(project.name);
   }
   

Sayfalandırma, uzun süre çalışan işlemler, hata işleme ve kimlik doğrulama stratejileri gibi daha fazla çalıştırılabilir örnek için GitHub'deki JavaScript için Databricks SDK'ları deposundaki örnekler klasörüne bakın.

Kimlik doğrulaması

Varsayılan olarak istemci, ana bilgisayar ve kimlik bilgileri dahil yapılandırmasını Databricks yapılandırma profilinden (~/.databrickscfg) ve DATABRICKS_* ortam değişkenlerinden okur. Bu ayarlarla, kodda herhangi bir kimlik bilgisi geçirmeniz gerekmez, bu nedenle örneğin:

import { PostgresClient } from '@databricks/sdk-postgres/v1';

// Resolves the host and credentials from the DEFAULT profile and DATABRICKS_* environment variables.
const client = new PostgresClient({});

Kimlik bilgilerini açıkça yapılandırmak için, @databricks/sdk-auth/credentials içinden bir yardımcıyı içe aktarın ve bunu credentials olarak iletin. Aşağıdaki örnek, Databricks kişisel erişim belirteci kimlik doğrulamasını yapılandırır.

import { PostgresClient } from '@databricks/sdk-postgres/v1';
import { newPatCredentials } from '@databricks/sdk-auth/credentials';

const client = new PostgresClient({
  host: 'https://my-company.databricks.com',
  credentials: newPatCredentials(MY_PAT_ENV_VAR),
});

Paket@databricks/sdk-auth, kullanıcıdan makineye (U2M) OAuth ve newU2mCredentials makineden makineye (M2M) OAuth ve varsayılan kimlik bilgisi zinciri dahil olmak üzere newM2mCredentials ek kimlik bilgisi sağlayıcıları sağlar. Azure Databricks kimlik doğrulaması hakkında daha fazla bilgi için bkz. Databricks birleşik kimlik doğrulaması.

Packages

Her Databricks API'si adlı @databricks/sdk-<api>ayrı bir paket olarak yayımlanır. İstemcisini paketin sürümüne sahip alt yoldan içeri aktarın. Örneğin, @databricks/sdk-postgres/v1 dışarı aktarır PostgresClient.

Kullanılabilir API paketlerinin tam listesi için bkz. JavaScript README için Databricks SDK'larındaki paketler .

Paylaşılan paketler

Her API istemcisi tarafından üç paket paylaşılır ve doğrudan içeri aktardığınız parçaları sağlar:

Ek kaynaklar

• JavaScript README için Databricks SDK'ları
• JavaScript için Databricks SDK'ları örnekleri
• Databricks birleşik kimlik doğrulaması