Compartir a través de

Biblioteca cliente de administración de Azure Purview para .NET: versión 1.0.0-beta.1

  • Artículo

La administración de Azure Purview contiene la cuenta de Purview y el servicio en la nube administrado de Purview MetdataPolicy.

Confíe en gran medida en la documentación del servicio y en la documentación del cliente de protocolo para usar esta biblioteca.

Código | fuente Paquete (NuGet) | Documentación del producto

Introducción

Instalar el paquete

Instale la biblioteca cliente de administración de Azure Purview para .NET con NuGet:

dotnet add package Azure.Analysis.Purview.Administration

Requisitos previos

Autenticar el cliente

Uso de Azure Active Directory

En este documento se muestra cómo usar DefaultAzureCredential para autenticarse mediante Azure Active Directory. Sin embargo, se aceptará cualquiera de las credenciales que ofrece Azure.Identity . Consulte la documentación de Azure.Identity para obtener más información sobre otras credenciales.

Una vez que haya elegido y configurado la credencial, puede crear instancias de o PurviewAccountClientPurviewMetadataPolicyClientPurviewMetadataRolesClient.

var credential = new DefaultAzureCredential();
var accountClient = new PurviewAccountClient(new Url("https://<my-account-name>.purview.azure.com"), credential);
var policyClient = new PurviewMetadataPolicyClient(new Url("https://<my-account-name>.purview.azure.com"), "myCollection", credential);
var roleClient = new PurviewMetadataRolesClient(new Url("https://<my-account-name>.purview.azure.com"), credential);

Conceptos clave

Métodos de protocolo

Las operaciones expuestas por el SDK de cuenta de Purview para .NET usan métodos de protocolo para exponer las operaciones REST subyacentes. Puede obtener más información sobre cómo usar clientes de SDK que usan métodos de protocolo en nuestra documentación.

Seguridad para subprocesos

Garantizamos que todos los métodos de instancia de cliente son seguros para subprocesos e independientes entre sí (instrucciones). Esto garantiza que la recomendación de reutilizar instancias de cliente siempre es segura, incluso entre subprocesos.

Conceptos adicionales

Opciones | de cliente Acceso a la respuesta | Operaciones | de larga duraciónControl de errores | Diagnóstico | Burla | Duración del cliente

Ejemplos

En la sección siguiente se muestra cómo inicializar y autenticar el cliente y, a continuación, obtener todas las definiciones de tipo del catálogo.

Obtener todas las definiciones de tipo de cuenta

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

var Response response = await client.GetAccountPropertiesAsync();
var responseDocument = JsonDocument.Parse(response.Content);
Console.WriteLine(responseDocument.RootElement.GetProperty("name"));

Enumerar todos los roles

var credential = new DefaultAzureCredential();
var client = new PurviewMetadataRolesClient(new Uri("https://<my-account-name>.purview.azure.com"), credential);

AsyncPageable<BinaryData> fetchResponse = client.GetMetadataRolesAsync(new());
await foreach (BinaryData item in fetchResponse)
{
    JsonElement fetchBodyJson = JsonDocument.Parse(item).RootElement;
    Console.WriteLine(fetchBodyJson.GetProperty("id"));
}

Solución de problemas

Configuración del registro de la consola

La manera más sencilla de ver los registros es habilitar el registro de la consola. Para crear un agente de escucha de registro del SDK de Azure que genere mensajes en la consola, use el método AzureEventSourceListener.CreateConsoleLogger.

// Setup a listener to monitor logged events.
using AzureEventSourceListener listener = AzureEventSourceListener.CreateConsoleLogger();

Para más información sobre otros mecanismos de registro, consulte aquí.

Pasos siguientes

Este SDK de cliente expone operaciones mediante métodos de protocolo. Puede obtener más información sobre cómo usar clientes del SDK que usan métodos de protocolo en nuestra documentación.

Contribuir

Consulte [CONTRIBUTING.md][contribución] para obtener más información sobre la compilación, las pruebas y la contribución a esta biblioteca.

Este proyecto agradece las contribuciones y sugerencias. La mayoría de las contribuciones requieren que acepte un Contrato de licencia para el colaborador (CLA) que declara que tiene el derecho a concedernos y nos concede los derechos para usar su contribución. Para obtener más información, visite cla.microsoft.com.

Cuando se envía una solicitud de incorporación de cambios, un bot de CLA determinará de forma automática si tiene que aportar un CLA y completar la PR adecuadamente (por ejemplo, la etiqueta, el comentario). Solo siga las instrucciones que le dará el bot. Solo será necesario que lo haga una vez en todos los repositorios con nuestro CLA.

Este proyecto ha adoptado el Código de conducta de Microsoft Open Source. Para más información, consulte las preguntas más frecuentes del código de conducta o póngase en contacto con opencode@microsoft.com si tiene cualquier otra pregunta o comentario.

Impresiones