Biblioteca de clientes da conta do Azure Purview para Python – versão 1.0.0b1

Artigo
04/05/2023

A Conta do Azure Purview é um serviço de nuvem totalmente gerenciado.

Confie fortemente na documentação do serviço e nos documentos do cliente para usar essa biblioteca

Código-fonte | Pacote (PyPI) | Documentação | de referência da API Documentação do produto

Introdução

Pré-requisitos

Python 2.7, ou 3.6 ou posteriores, é necessário para usar esse pacote.
Você deve ter uma assinatura do Azure e um Purview para usar esse pacote.

Criar um recurso do Purview

Siga estas instruções para criar seu recurso do Purview

Instalar o pacote

Instale a biblioteca de clientes da Conta do Azure Purview para Python com pip:

pip install azure-purview-account

Autenticar o cliente

Para usar uma credencial de token do AAD (Azure Active Directory), forneça uma instância do tipo de credencial desejado obtido da biblioteca azure-identity .

Para autenticar com o AAD, primeiro você deve instalar azure-identityo pip e habilitar a autenticação do AAD em seu recurso do Purview

Após a instalação, você pode escolher qual tipo de credencial de azure.identity usar. Por exemplo, DefaultAzureCredential pode ser usado para autenticar o cliente:

Defina os valores da ID do cliente, da ID do locatário e do segredo do cliente do aplicativo AAD como variáveis de ambiente: AZURE_CLIENT_ID, AZURE_TENANT_ID AZURE_CLIENT_SECRET

Use a credencial de token retornada para autenticar o cliente:

from azure.purview.account import PurviewAccountClient
from azure.identity import DefaultAzureCredential

credential = DefaultAzureCredential()
client = PurviewAccountClient(endpoint="https://<my-account-name>.purview.azure.com", credential=credential)

Principais conceitos

Cliente

Exemplos

A seção a seguir mostra como inicializar e autenticar seu cliente e, em seguida, listar todas as suas chaves.

Obter chaves

Obter chaves

from azure.purview.account import PurviewAccountClient
from azure.identity import DefaultAzureCredential

credential = DefaultAzureCredential()
client = PurviewAccountClient(endpoint="https://<my-account-name>.purview.azure.com", credential=credential)
response = client.accounts.get_access_keys()
print(response)

Solução de problemas

Geral

O cliente da Conta do Purview gerará exceções se o código de status das respostas não estiver definido.

Log

Essa biblioteca usa a biblioteca de log padrão para registro em log. As informações básicas sobre sessões HTTP (URLs, cabeçalhos etc.) são registradas no nível info.

O log detalhado no nível de DEBUG, incluindo corpos de solicitação/resposta e cabeçalhos não redigidos, pode ser habilitado em um cliente com o argumento de palavra-chave logging_enable:

import sys
import logging
from azure.identity import DefaultAzureCredential
from azure.purview.account import PurviewAccountClient

# 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>.purview.azure.com"
credential = DefaultAzureCredential()

# This client will log detailed information about its HTTP sessions, at DEBUG level
client = PurviewAccountClient(endpoint=endpoint, credential=credential, logging_enable=True)

Da mesma forma, logging_enable o pode habilitar o log detalhado para uma única chamada, mesmo quando ela não está habilitada para o cliente:

result = client.accounts.get_access_keys(logging_enable=True)

Próximas etapas

Para obter exemplos mais genéricos, consulte nossos documentos de cliente.

Contribuição

Este projeto aceita contribuições e sugestões. A maioria das contribuições exige que você concorde com um CLA (Contrato de Licença do Colaborador) declarando que você tem o direito de nos conceder, e de fato concede, os direitos de usar sua contribuição. Para obter detalhes, visite cla.microsoft.com.

Quando você envia uma solicitação de pull, um bot do CLA determina automaticamente se você precisa fornecer um CLA e preencher a PR corretamente (por exemplo, rótulo, comentário). Basta seguir as instruções fornecidas pelo bot. Você só precisará fazer isso uma vez em todos os repositórios que usam nosso CLA.

Este projeto adotou o Código de Conduta de Software Livre da Microsoft. Para obter mais informações, confira as Perguntas frequentes sobre o Código de Conduta ou contate opencode@microsoft.com para enviar outras perguntas ou comentários.

Compartilhar via