Pustaka klien Pemindaian Azure Purview untuk Python - versi 1.0.0b2

Artikel
04/05/2023

Pemindaian Azure Purview adalah layanan cloud terkelola sepenuhnya yang penggunanya dapat memindai data Anda ke dalam data estate Anda (juga dikenal sebagai katalog Anda). Pemindaian adalah proses di mana katalog terhubung langsung ke sumber data pada jadwal yang ditentukan pengguna.

Pindai data Anda ke dalam katalog Anda
Memeriksa data Anda
Mengekstrak skema dari data Anda

Harap sangat bergantung pada dokumentasi layanan dan dokumen klien kami untuk menggunakan pustaka ini

Kode sumber | Paket (PyPI) | Dokumentasi| referensi API Dokumentasi produk

Pengelakan

Dukungan paket Azure SDK Python untuk Python 2.7 berakhir pada 01 Januari 2022. Untuk informasi lebih lanjut dan pertanyaan, silakan merujuk ke https://github.com/Azure/azure-sdk-for-python/issues/20691

Memulai

Prasyarat

Python 2.7, atau 3.6 atau yang lebih baru diperlukan untuk menggunakan paket ini.
Anda harus memiliki langganan Azure dan Purview untuk menggunakan paket ini.

Membuat Sumber Daya Purview

Ikuti petunjuk berikut untuk membuat sumber daya Purview Anda

Instal paketnya

Instal pustaka klien Pemindaian Azure Purview untuk Python dengan pip:

pip install azure-purview-scanning

Mengautentikasi klien

Untuk menggunakan kredensial token Azure Active Directory (AAD), berikan instans jenis kredensial yang diinginkan yang diperoleh dari pustaka identitas azure .

Untuk mengautentikasi dengan AAD, Anda harus terlebih dahulu menginstal azure-identitypip dan mengaktifkan autentikasi AAD pada sumber daya Purview Anda

Setelah penyiapan, Anda dapat memilih jenis kredensial mana dari azure.identity yang akan digunakan. Sebagai contoh, DefaultAzureCredential dapat digunakan untuk mengautentikasi klien:

Atur nilai ID klien, ID penyewa, dan rahasia klien aplikasi AAD sebagai variabel lingkungan: AZURE_CLIENT_ID, AZURE_TENANT_ID, AZURE_CLIENT_SECRET

Gunakan kredensial token yang dikembalikan untuk mengautentikasi klien:

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)

Konsep utama

Klien

Paket ini menawarkan penyusun permintaan sehingga Anda dapat membangun permintaan http dan mengirim permintaan ini ke layanan menggunakan send_request metode . Untuk informasi selengkapnya tentang cara menggunakan penyusun permintaan dan klien kami, lihat di sini.

Contoh

Bagian berikut ini memperlihatkan kepada Anda cara menginisialisasi dan mengautentikasi klien Anda, lalu mencantumkan semua sumber data Anda.

Daftar Semua Sumber Data

Daftar Semua Sumber Data

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)

Pemecahan Masalah

Umum

Klien Pemindaian Purview akan memunculkan pengecualian yang ditentukan dalam [Azure Core][azure_core] jika Anda memanggil .raise_for_status() respons Anda.

Pembuatan Log

Pustaka ini menggunakan pustaka pengelogan standar untuk pengelogan. Informasi dasar tentang sesi HTTP (URL, header, dll.) dicatat di tingkat INFO.

Pengelogan tingkat DEBUG mendetail, termasuk isi permintaan/respons dan header yang tidak diedit, dapat diaktifkan pada klien dengan argumen kata kunci logging_enable:

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)

Demikian pula, logging_enable dapat mengaktifkan pengelogan terperinci untuk satu send_request panggilan, bahkan ketika tidak diaktifkan untuk klien:

result = client.data_sources.list_all(logging_enable=True)

Langkah berikutnya

Untuk sampel umum lainnya, lihat dokumen klien kami.

Berkontribusi

Proyek ini menyambut baik kontribusi dan saran. Sebagian besar kontribusi mengharuskan Anda menyetujui Perjanjian Lisensi Kontributor (CLA) yang menyatakan bahwa Anda memiliki hak untuk, dan benar-benar melakukannya, memberi kami hak untuk menggunakan kontribusi Anda. Untuk detailnya, kunjungi cla.microsoft.com.

Ketika Anda mengirimkan permintaan tarik, CLA-bot akan secara otomatis menentukan apakah Anda perlu memberikan CLA dan menghias PR dengan tepat (misalnya, label, komentar). Cukup ikuti instruksi yang diberikan oleh bot. Anda hanya perlu melakukan ini sekali di semua repos menggunakan CLA kami.

Proyek ini telah mengadopsi Kode Etik Sumber Terbuka Microsoft. Untuk informasi selengkapnya, lihat Tanya Jawab Umum Tata Tertib atau hubungi opencode@microsoft.com untuk pertanyaan atau komentar lainnya.

Bagikan melalui