biblioteca cliente de puntos de conexión privados administrados de Azure Synapse Analytics para .NET: versión 1.0.0-beta.5
Este directorio contiene el subconjunto código abierto del SDK de .NET. Para obtener documentación del SDK completo de Azure, consulte el Centro para desarrolladores de Microsoft Azure .NET.
Azure Synapse es un servicio de análisis ilimitado que reúne el almacenamiento de datos empresariales y el análisis de macrodatos. Le ofrece la libertad de consultar los datos como prefiera, ya sea a petición sin servidor o con recursos aprovisionados, a escala. Azure Synapse reúne estos dos mundos con una experiencia unificada para ingerir, preparar, administrar y servir datos para las necesidades inmediatas de inteligencia empresarial y aprendizaje automático.
Los puntos de conexión privados administrados son puntos de conexión privados creados en el área de trabajo administrada de Microsoft Azure Virtual Network establecer un vínculo privado a los recursos de Azure. Azure Synapse administra estos puntos de conexión privados en su nombre.
La biblioteca cliente de puntos de conexión privados administrados de Azure Synapse Analytics permite administrar mediante programación puntos de conexión privados.
Introducción
El SDK completo de Microsoft Azure se puede descargar desde la página de descargas de Microsoft Azure y se incluye con compatibilidad para compilar paquetes de implementación, integrar con herramientas, herramientas de línea de comandos enriquecidas, etc.
Para obtener la mejor experiencia de desarrollo, los desarrolladores deben usar los paquetes NuGet oficiales de Microsoft para bibliotecas. Los paquetes NuGet se actualizan periódicamente con nuevas funcionalidades y revisiones.
Instalar el paquete
Instale la biblioteca cliente de puntos de conexión privados administrados de Azure Synapse Analytics para .NET con NuGet:
dotnet add package Azure.Analytics.Synapse.ManagedPrivateEndpoints --version 1.0.0-preview.1
Prerrequisitos
- Suscripción de Azure: Para usar los servicios de Azure, incluido Azure Synapse, necesitará una suscripción. Si no tiene una cuenta de Azure existente, puede registrarse para obtener una evaluación gratuita o usar las ventajas de la suscripción de Visual Studio al crear una cuenta.
- Un área de trabajo de Azure Synapse existente. Si necesita crear un área de trabajo de Azure Synapse, puede usar Azure Portal o la CLI de Azure.
Si usa la CLI de Azure, el comando tiene el siguiente aspecto:
az synapse workspace create \
--name <your-workspace-name> \
--resource-group <your-resource-group-name> \
--storage-account <your-storage-account-name> \
--file-system <your-storage-file-system-name> \
--sql-admin-login-user <your-sql-admin-user-name> \
--sql-admin-login-password <your-sql-admin-user-password> \
--location <your-workspace-location>
Autenticar el cliente
Para interactuar con el servicio Azure Synapse Analytics, deberá crear una instancia de la clase ManagedPrivateEndpointClient. Necesita un punto de conexión de área de trabajo, que puede ver como "Punto de conexión de desarrollo" en el portal y credenciales de secreto de cliente (id. de cliente, secreto de cliente, identificador de inquilino) para crear instancias de un objeto de cliente.
La autenticación de credenciales de secreto de cliente se usa en esta sección de introducción, pero puede encontrar más formas de autenticarse con la identidad de Azure. Para usar el proveedor DefaultAzureCredential que se muestra a continuación u otros proveedores de credenciales proporcionados con el SDK de Azure, debe instalar el paquete Azure.Identity:
Install-Package Azure.Identity
Conceptos clave
ManagedPrivateEndpointClient
Con un ManagedPrivateEndpointClient
puede obtener puntos de conexión privados desde el área de trabajo, crear un nuevo punto de conexión privado y eliminar puntos de conexión privados.
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
El paquete Azure.Analytics.Synapse.ManagedPrivateEndpoints admite API sincrónicas y asincrónicas. En la siguiente sección se tratan algunas de las tareas relacionadas con la supervisión de Azure Synapse Analytics más comunes:
Ejemplos de puntos de conexión privados
- Creación de un punto de conexión privado
- Recuperación de un punto de conexión privado
- Enumeración de puntos de conexión privados
- Eliminación de un punto de conexión privado
Creación de un punto de conexión privado
string managedVnetName = "default";
string managedPrivateEndpointName = "myPrivateEndpoint";
string fakedStorageAccountName = "myStorageAccount";
string privateLinkResourceId = $"/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/myResourceGroup/providers/Microsoft.Storage/accounts/{fakedStorageAccountName}";
string groupId = "blob";
client.Create(managedVnetName, new ManagedPrivateEndpoint
{
Properties = new ManagedPrivateEndpointProperties
{
PrivateLinkResourceId = privateLinkResourceId,
GroupId = groupId
}
});
Recuperación de un punto de conexión privado
ManagedPrivateEndpoint retrievedPrivateEndpoint = client.Get(managedVnetName, managedPrivateEndpointName);
Console.WriteLine(retrievedPrivateEndpoint.Id);
Enumeración de puntos de conexión privados
List<ManagedPrivateEndpoint> privateEndpoints = client.List(managedVnetName).ToList();
foreach (ManagedPrivateEndpoint privateEndpoint in privateEndpoints)
{
Console.WriteLine(privateEndpoint.Id);
}
Eliminación de un punto de conexión privado
client.Delete(managedVnetName, managedPrivateEndpointName);
Para compilar
Para obtener información sobre cómo compilar la biblioteca cliente de Azure Synapse, consulte Creación del Microsoft Azure SDK para .NET
Versiones de .NET Framework de destino
Para obtener información sobre las plataformas de destino de la biblioteca cliente de Azure Synapse, consulte las plataformas de destino del Microsoft Azure SDK para .NET.
Solución de problemas
Abra el problema en github.
Pasos siguientes
El siguiente paso es agregar más ejemplos
Contribuir
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.
Azure SDK for .NET
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de