Python için Azure Purview Tarama istemci kitaplığı - sürüm 1.0.0b2
Azure Purview Tarama, kullanıcıları verilerinizi veri varlığınızda ( kataloğunuz olarak da bilinir) tarayabilen, tam olarak yönetilen bir bulut hizmetidir. Tarama, kataloğun kullanıcı tarafından belirtilen bir zamanlamaya göre doğrudan bir veri kaynağına bağlandığı bir işlemdir.
- Verilerinizi kataloğunuzda tarama
- Verilerinizi inceleme
- Verilerinizden şema ayıklama
Bu kitaplığı kullanmak için lütfen hizmetin belgelerine ve istemci belgelerimize yoğun bir şekilde güvenin
Kaynak kodu | Paket (PyPI) | API başvuru belgeleri| Ürün belgeleri
Bildirim
Python 2.7 için Azure SDK Python paketleri desteği 01 Ocak 2022'de sona eriyor. Daha fazla bilgi ve soru için lütfen https://github.com/Azure/azure-sdk-for-python/issues/20691
Başlarken
Önkoşullar
- Bu paketi kullanmak için Python 2.7 veya 3.6 veya üzeri gereklidir.
- Bu paketi kullanmak için bir Azure aboneliğiniz ve purview'niz olmalıdır.
Purview Kaynağı Oluşturma
Purview kaynağınızı oluşturmak için bu yönergeleri izleyin
Paketi yükleme
Pip ile Python için Azure Purview Scan istemci kitaplığını yükleyin:
pip install azure-purview-scanning
İstemcinin kimliğini doğrulama
Azure Active Directory (AAD) belirteci kimlik bilgilerini kullanmak için azure-identity kitaplığından alınan istenen kimlik bilgisi türünün bir örneğini sağlayın.
AAD ile kimlik doğrulaması yapmak için önce Purview kaynağınızda AAD kimlik doğrulamasınıyüklemenizazure-identity
ve etkinleştirmeniz gerekir
Kurulumdan sonra azure.identity'den hangi kimlik bilgisi türünü kullanacağınızı seçebilirsiniz. Örneğin, istemcinin kimliğini doğrulamak için DefaultAzureCredential kullanılabilir:
AAD uygulamasının istemci kimliği, kiracı kimliği ve istemci gizli dizisi değerlerini ortam değişkenleri olarak ayarlayın: AZURE_CLIENT_ID, AZURE_TENANT_ID, AZURE_CLIENT_SECRET
İstemcinin kimliğini doğrulamak için döndürülen belirteç kimlik bilgilerini kullanın:
from azure.purview.scanning import PurviewScanningClient
from azure.identity import DefaultAzureCredential
credential = DefaultAzureCredential()
client = PurviewScanningClient(endpoint="https://<my-account-name>.scan.purview.azure.com", credential=credential)
Önemli kavramlar
İstemci
Bu paket, http istekleri oluşturabilmeniz ve yöntemini kullanarak send_request
bu istekleri hizmete gönderebilmeniz için istek oluşturucuları sunar.
İstek oluşturucuları ve müşterilerimizi kullanma hakkında daha fazla bilgi için buraya bakın.
Örnekler
Aşağıdaki bölümde, istemcinizi başlatma ve kimlik doğrulaması yapma ve ardından tüm veri kaynaklarınızı listeleme işlemleri gösterilmektedir.
Tüm Veri Kaynaklarını Listele
from azure.purview.scanning import PurviewScanningClient
from azure.identity import DefaultAzureCredential
from azure.core.exceptions import HttpResponseError
credential = DefaultAzureCredential()
client = PurviewScanningClient(endpoint="https://<my-account-name>.scan.purview.azure.com", credential=credential)
try:
response = client.data_sources.list_all()
result = [item for item in response]
print(result)
except HttpResponseError as e:
print(e)
Sorun giderme
Genel
Purview Scan istemcisi, yanıtlarınızı çağırırsanız .raise_for_status()
[Azure Core][azure_core] içinde tanımlanan özel durumları tetikler.
Günlüğe Kaydetme
Bu kitaplık, günlüğe kaydetme için standart günlük kitaplığını kullanır. HTTP oturumlarıyla ilgili temel bilgiler (URL'ler, üst bilgiler vb.) BİlGİ düzeyinde günlüğe kaydedilir.
İstek/yanıt gövdeleri ve işlenmemiş üst bilgiler de dahil olmak üzere ayrıntılı HATA AYıKLAMA düzeyi günlüğü, anahtar sözcük bağımsız değişkeniyle logging_enable
bir istemcide etkinleştirilebilir:
import sys
import logging
from azure.identity import DefaultAzureCredential
from azure.purview.scanning import PurviewScanningClient
# Create a logger for the 'azure' SDK
logger = logging.getLogger('azure')
logger.setLevel(logging.DEBUG)
# Configure a console output
handler = logging.StreamHandler(stream=sys.stdout)
logger.addHandler(handler)
endpoint = "https://<my-account-name>.scan.purview.azure.com"
credential = DefaultAzureCredential()
# This client will log detailed information about its HTTP sessions, at DEBUG level
client = PurviewScanningClient(endpoint=endpoint, credential=credential, logging_enable=True)
Benzer şekilde, logging_enable
istemci için etkinleştirilmemiş olsa bile tek send_request
bir çağrı için ayrıntılı günlüğe kaydetmeyi etkinleştirebilir:
result = client.data_sources.list_all(logging_enable=True)
Sonraki adımlar
Daha genel örnekler için istemci belgelerimize bakın.
Katkıda bulunma
Bu proje, katkı ve önerilere açıktır. Çoğu durumda, sağladığınız katkıyı kullanmamız için bize hak tanıma hakkına sahip olduğunuzu ve bu hakkı bize tanıdığınızı bildiren bir Katkıda Bulunan Lisans Sözleşmesi’ni (CLA) kabul etmeniz gerekir. Ayrıntılar için cla.microsoft.com adresini ziyaret edin.
Bir çekme isteği gönderdiğinizde, CLA robotu bir CLA sağlamanız gerekip gerekmediğini otomatik olarak belirler ve çekme isteğini uygun şekilde donatır (örn. etiket, açıklama). Robot tarafından sağlanan yönergeleri izlemeniz yeterlidir. Bu işlemi, CLA’mızı kullanarak tüm depolarda yalnızca bir kere yapmanız gerekir.
Bu proje Microsoft Open Source Code of Conduct (Microsoft Açık Kaynak Kullanım Kuralları) belgesinde listelenen kurallara uygundur. Daha fazla bilgi için Kullanım Kuralları SSS bölümüne bakın veya ek sorular veya yorumlarla iletişime geçin opencode@microsoft.com .
Azure SDK for Python
Geri Bildirim
https://aka.ms/ContentUserFeedback.
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz.Gönderin ve geri bildirimi görüntüleyin