Клиентская библиотека сканирования Azure Purview для Python, версия 1.0.0b2
Сканирование Azure Purview — это полностью управляемая облачная служба, пользователи которой могут сканировать данные в пространстве данных (также известном как каталог). Сканированием называется процесс, при котором каталог подключается напрямую к источнику данных по заданному пользователем расписанию.
- Сканирование данных в каталоге
- Изучение данных
- Извлечение схем из данных
Чтобы использовать эту библиотеку, в значительной степени полагайтесь на документацию службы и наши клиентские документы .
Исходный код | Пакет (PyPI) | Справочная документация по| API Документация по продукту
Заявление об отказе
Поддержка пакетов Python пакета Azure SDK для Python 2.7 заканчивается 1 января 2022 г. Дополнительные сведения и вопросы см. на https://github.com/Azure/azure-sdk-for-python/issues/20691
Начало работы
Предварительные требования
- Для использования этого пакета требуется Python 2.7 или 3.6 (или более поздней версии).
- Для использования этого пакета вам потребуется подписка Azure и Purview .
Создание ресурса Purview
Следуйте этим инструкциям, чтобы создать ресурс Purview.
Установка пакета
Установите клиентую библиотеку сканирования Azure Purview для Python с помощью pip:
pip install azure-purview-scanning
Аутентификация клиента
Чтобы использовать учетные данные маркера Azure Active Directory (AAD), укажите экземпляр нужного типа учетных данных, полученных из библиотеки azure-identity .
Для проверки подлинности с помощью AAD необходимо сначала установитьazure-identity
и включить проверку подлинности AAD в ресурсе Purview.
После настройки можно выбрать тип учетных данных из azure.identity для использования. Например, для проверки подлинности клиента можно использовать DefaultAzureCredential :
Задайте значения идентификатора клиента, идентификатора клиента и секрета клиента приложения AAD в качестве переменных среды: AZURE_CLIENT_ID, AZURE_TENANT_ID AZURE_CLIENT_SECRET
Используйте возвращенные учетные данные маркера для проверки подлинности клиента:
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)
Основные понятия
Клиент
Этот пакет предлагает построитель запросов, что позволяет создавать HTTP-запросы и отправлять эти запросы в службу с помощью send_request
метода .
Дополнительные сведения об использовании построителей запросов и наших клиентов см. здесь.
Примеры
В следующем разделе показано, как инициализировать и проверить подлинность клиента, а затем перечислить все источники данных.
Перечисление всех источников данных
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)
Устранение неполадок
Общие сведения
Клиент проверки Purview будет вызывать исключения, определенные в [Azure Core][azure_core], если вы вызываете .raise_for_status()
в ответах.
Ведение журнала
Эта библиотека использует стандартную библиотеку ведения журнала для ведения журнала. Основные сведения о сеансах HTTP (URL-адреса, заголовки и т. д.) регистрируются на уровне INFO.
С помощью аргумента-ключевого слова logging_enable
можно включить в клиенте ведение журнала на уровне отладки (DEBUG), на котором фиксируются сведения о телах запросов и ответов, а также заголовки без изменений:
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)
Аналогичным logging_enable
образом можно включить подробное ведение журнала для одного send_request
вызова, даже если он не включен для клиента:
result = client.data_sources.list_all(logging_enable=True)
Дальнейшие действия
Дополнительные универсальные примеры см. в нашей клиентской документации.
Участие
На этом проекте приветствуются публикации и предложения. Для участия в большинстве процессов по разработке документации необходимо принять лицензионное соглашение участника (CLA), в котором указывается, что вы предоставляете нам права на использование ваших публикаций. Дополнительные сведения см. на странице cla.microsoft.com.
При отправке запроса на включение внесенных изменений CLA-бот автоматически определит необходимость предоставления соглашения CLA и соответствующего оформления запроса на включение внесенных изменений (например, добавление метки, комментария). Просто следуйте инструкциям бота. Будет достаточно выполнить их один раз для всех репозиториев, поддерживающих соглашение CLA.
В рамках этого проекта действуют правила поведения в отношении продуктов с открытым исходным кодом Майкрософт. Дополнительные сведения см. в разделе часто задаваемых вопросов о правилах поведения или обратитесь к opencode@microsoft.com с любыми дополнительными вопросами или комментариями.
Azure SDK for Python