Veritabanı örneği oluşturma ve yönetme

Önemli

Bu özellik şu bölgelerde Genel Önizleme aşamasındadır: westus, westus2, eastus, , eastus2, centralus, , southcentralus, northeurope, westeuropeaustraliaeast, brazilsouth, canadacentral, centralindia, southeastasia, . uksouth

OLTP iş yüklerini kullanmaya başlamak için Azure Databricks kullanıcı arabirimini, API çağrısını, Python SDK'sını veya CLI'yı kullanarak bir Lakebase Sağlanan veritabanı örneği oluşturun.

Veritabanı örneği oluşturma

Önerilen varsayılanlarla bir veritabanı örneği oluşturun. Örnek adı sağlamanız gerekir (yalnızca 1-63 karakter, harf ve kısa çizgi). Oluşturucu olarak rolü olan veritabanı sahibi databricks_superuser sizsiniz.

Çoğu çalışma alanı kullanıcısı varsayılan olarak veritabanı örnekleri oluşturabilir. İzin sorunlarıyla karşılaşırsanız bkz. veritabanı örneği izinleri.

Kullanıcı Arayüzü (UI)

Çalışma alanı kenar çubuğunda İşlem'e tıklayın.
Lakebase Sağlanmış sekmesine tıklayın.
Veritabanı örneği oluştur'a tıklayın.
Bir veritabanı örneği adı girin (yalnızca 1-63 karakter, harf ve kısa çizgi).
Oluştur'utıklayın.

Python SDK'sı

from databricks.sdk import WorkspaceClient
from databricks.sdk.service.database import DatabaseInstance

# Initialize the Workspace client
w = WorkspaceClient()

# Create a database instance
instance = w.database.create_database_instance(
    DatabaseInstance(
        name="my-database-instance",
        capacity="CU_1"
    )
)

print(f"Created database instance: {instance.name}")
print(f"Connection endpoint: {instance.read_write_dns}")

CLI

# Create a database instance
databricks database create-database-instance my-database-instance \
  --capacity CU_1

# Create with advanced options (using JSON for more complex parameters)
databricks database create-database-instance \
  --json '{
    "name": "my-database-instance",
    "capacity": "CU_2",
    "retention_window_in_days": 14
  }'

Kıvrım

Bir veritabanı örneği oluşturun ve bir bekletme penceresi belirtin.

export PAT=<YOUR_PAT>
export INSTANCE_NAME="instance_name"

> curl -X POST --header "Authorization: Bearer ${DATABRICKS_TOKEN}" https://[your databricks workspace]/api/2.0/database/instances \
--data-binary @- << EOF
{
  "name": "$INSTANCE_NAME",
  "capacity": "CU_1",
  "retention_window_in_days": 14
}
EOF

Gelişmiş ayarlar

Örneğinizi düzenleyerek oluşturma sırasında veya oluşturulduktan sonra da bu özellikleri yapılandırabilirsiniz:

Özellik	Description
Sunucusuz bütçe ilkesi	Sunucusuz kullanımı ve faturalamayı belirli bütçelerle ilişkilendirmek için veritabanı örneğiniz için bir bütçe ilkesi seçin. Özel etiketler de ekleyebilirsiniz.
Örnek boyutu	İş yükü performans gereksinimleriniz için işlem kaynaklarını ölçeklendirin (varsayılan olarak 2 CU'dır).
Geri yükleme penceresi	Belirli bir noktaya kurtarma için bekletme penceresini (2-35 gün, varsayılan 7 gün) ayarlayın.
Yüksek kullanılabilirlik	Üretim iş yükleri için iş sürekliliğini sağlamak için yük devretme düğümleri ekleyin.
Üst öğeden oluştur	Var olan bir veritabanı örneğinden bir yazma kopyası oluşturun.

Örneği durdurma veya başlatma

Veritabanı örneğini durdurmak veya başlatmak için bu örnekte izinlere sahip CAN MANAGE olmanız gerekir. Örneği durdurmak veya başlatmak için Azure Databricks kullanıcı arabirimini, API çağrısını, Python SDK'sını veya CLI'yı kullanın.

Kullanıcı Arayüzü (UI)

Çalışma alanı kenar çubuğunda İşlem'e tıklayın.
Lakebase Sağlanmış sekmesine tıklayın.
Durdurmak veya başlatmak istediğiniz veritabanı örneğine tıklayın.
Sayfanın sağ üst köşesindeki Durdur veya Başlat'a tıklayın.

Python SDK'sı

from databricks.sdk import WorkspaceClient
from databricks.sdk.service.database import DatabaseInstance

# Initialize the Workspace client
w = WorkspaceClient()

# Stop a database instance
instance_name = "my-database-instance"
w.database.update_database_instance(
    name=instance_name,
    database_instance=DatabaseInstance(
        name=instance_name,
        stopped=True
    ),
    update_mask="*"
)
print(f"Stopped database instance: {instance_name}")

# Start a database instance
w.database.update_database_instance(
    name=instance_name,
    database_instance=DatabaseInstance(
        name=instance_name,
        stopped=False
    ),
    update_mask="*"
)
print(f"Started database instance: {instance_name}")

CLI

# Stop a database instance
databricks database update-database-instance my-database-instance \
  --json '{
    "stopped": true
  }'

# Start a database instance
databricks database update-database-instance my-database-instance \
  --json '{
    "stopped": false
  }'

Kıvrım

Aşağıdaki API çağrısı bir veritabanı örneğini durdurur.

-X PATCH --header "Authorization: Bearer ${DATABRICKS_TOKEN}" https://$WORKSPACE/api/2.0/database/instances/$INSTANCE_NAME \
--data-binary @- << EOF
{
  "stopped": true
}
EOF

Aşağıdaki API çağrısı bir veritabanı örneği başlatır.

curl -X PATCH --header "Authorization: Bearer ${DATABRICKS_TOKEN}" https://$WORKSPACE/api/2.0/database/instances/$INSTANCE_NAME \
--data-binary @- << EOF
{
  "stopped": false
}
EOF

Durdurulduğunda davranış

Veritabanı örneği davranışı:

Veriler korundu.
Örnek, okuma veya yazma işlemleri için kullanılamaz.
Eşitlenen tablolar okuma hizmeti vermez.
Lakeflow Spark Bildirimli İşlem Hatları (LDP), durdurulan örnekleri algılamaz ve hata döndürebilir.
Durdurulan örneklerde kayıtlı kataloglar kullanıcı arabiriminde şema ayrıntılarını göstermez.

İşlevsel sınırlamalar:

DatabaseTables veya DatabaseCatalogs oluşturamaz veya silemezsiniz.
Durdurulmuş örneği silebilir veya yeniden boyutlandırabilirsiniz. Örnek yeniden başlatıldığında kapasite değişiklikleri etkili olur.
İşlem hatlarını durdurabilirsiniz.

Başlatıldığında davranış

Örnek STARTING durumuna girer ve hazır olduğunda AVAILABLE olur.

Sınırlamalar

LDP durdurulmuş örnekleri algılamaz ve hata döndürebilir.
Durdurulan örneklerde kayıtlı kataloglar kullanıcı arabiriminde şema ayrıntılarını göstermez.

Örneği silme

Veritabanı örneğini silerken dikkatli olun; bunu yaptığınızda ilişkili tüm veriler silinir.

Veritabanı örneği üzerinde CAN MANAGE izinlerine sahip olmanız gerekir. Tabloların veya katalogların sahibi siz değilseniz, sahipliği kendinize yeniden atamanız gerekir. Çalışma alanı yöneticileri sahip olmadığı veritabanı örneklerini silebilir.

Databricks, veritabanı örneğini silmeden önce tüm ilişkili Unity Kataloğu kataloglarının, eşitlenen tabloların ve alt örneklerin silinmesini önerir. Aksi takdirde, katalogları görüntülemeye veya bunlara başvuran SQL sorgularını çalıştırmaya çalışmak hatalara neden olur.

Kullanıcı Arayüzü (UI)

Çalışma alanı kenar çubuğunda İşlem'e tıklayın.
Lakebase Sağlanmış sekmesine tıklayın.
Silmek istediğiniz veritabanı örneğini seçin.
Veritabanı örneğiyle ilişkili veritabanı kataloglarının tam listesini görüntülemek için Kataloglar sekmesine tıklayın.
Her veritabanı kataloğu için, yönetilen kataloglarda bulunan ve veritabanı katalogları olarak kaydedilmeyenler de dahil olmak üzere eşitlenen tüm tabloları silin.
> Kataloğu silin.

Python SDK'sı

from databricks.sdk import WorkspaceClient

# Initialize the Workspace client
w = WorkspaceClient()

# Delete a database instance
instance_name = "my-database-instance"
w.database.delete_database_instance(
    name=instance_name,
    purge=True  # Required to delete the instance
)
print(f"Deleted database instance: {instance_name}")

# Delete with force option (to delete child instances too)
w.database.delete_database_instance(
    name=instance_name,
    force=True,  # Delete child instances too
    purge=True
)

CLI

# Delete a database instance
databricks database delete-database-instance my-database-instance \
  --purge

# Delete with force option (to delete child instances too)
databricks database delete-database-instance my-database-instance \
  --json '{
    "force": true,
    "purge": true
  }'

Kıvrım

purge=true veritabanı örneğini silmek için belirtilmelidir.

curl -X DELETE --header "Authorization: Bearer ${DATABRICKS_TOKEN}" https://$WORKSPACE/api/2.0/database/instances/$INSTANCE_NAME?purge=true

Veritabanı örneğinin sunucusuz bütçe ilkesini güncelleştirme

Sunucusuz bütçe ilkeleri, ilkeye atanan bir kullanıcı tarafından tahakkuk eden sunucusuz işlem etkinliklerine uygulanan etiketlerden oluşur. Bir veritabanı örneğini kullanım ilkesiyle etiketleyerek faturalama ve kullanım maliyetlerini belirli ilkelerle ilişkilendirerek sunucusuz kaynaklar arasında harcamaları izlemeyi, yönetmeyi ve denetlemeyi kolaylaştırabilirsiniz.

Veritabanı örneğinin bütçe ilkesini güncelleştirmek için kullanıcı arabirimini kullanın:

Çalışma alanı kenar çubuğunda İşlem'e tıklayın.
Lakebase Sağlanmış sekmesine tıklayın.
Faturalama ilkesini güncelleştirmek istediğiniz veritabanı örneğini seçin.
Sağ üstteki Düzenle'ye tıklayın.
Sunucusuz bütçe ilkesi seçin.
Kaydet'e tıklayın.

Sonraki Adımlar

Mevcut Unity Kataloğu tablolarındaki verileri eşitleyin.
Dış araçlardan, SQL düzenleyicisinden veya not defterinden veritabanı örneğinizi bağlayın ve sorgulayın.
Unity Kataloğu'nda veritabanı örneğini kaydedin.
Diğer kullanıcıların Azure Databricks'ten veritabanı örneğine erişmesine izin verin. Bkz. İzinleri yönetme ve Postgres rollerini yönetme.

Sınırlamalar ve gereksinimler

Aşağıdaki bölümlerde yönetilen veritabanı örnekleri için sınırlar ve yapılandırma gereksinimleri açıklanmaktadır. Örnek oluşturma ve kullanımıyla ilgili kısıtlamalar için bkz. Sınırlamalar ve dikkat edilmesi gerekenler.

Örnek adı gereksinimleri

1 ile 63 karakter uzunluğunda olmalıdır.
Bir harfle başlamalıdır.
Yalnızca alfasayısal karakterler ve tireler içerebilir.
Arka arkaya iki kısa çizgi eklenemez.

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?

Last updated on 2025-12-19

Aracılığıyla paylaş

Veritabanı örneği oluşturma ve yönetme