Aracılığıyla paylaş

Python için Azure Purview Tarama istemci kitaplığı - sürüm 1.0.0b2

  • Makale

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

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 .