Operaciones de administración de cuentas en Azure Data Lake Storage Gen1 mediante el SDK de .NET.
En este artículo aprenderá a realizar operaciones de administración de cuentas en Azure Data Lake Storage Gen1 con el SDK de .NET. Las operaciones de administración de cuentas incluyen, por ejemplo, la creación o eliminación de cuentas de Data Lake Storage Gen1, o su enumeración en una suscripción de Azure.
Para obtener instrucciones sobre cómo realizar operaciones de administración de datos en Data Lake Storage Gen1 con el SDK de .NET, consulte Filesystem operations on Data Lake Storage Gen1 using .NET SDK (Operaciones de sistema de archivos en Azure Data Lake Storage Gen1 con el SDK de .NET).
Prerrequisitos
Visual Studio 2013 o superior. En las instrucciones siguientes se usa Visual Studio 2019.
Una suscripción de Azure. Consulte Obtención de una versión de evaluación gratuita.
Creación de una aplicación .NET
En Visual Studio, en el menú Archivo, seleccione Nuevo y, a continuación, Proyecto.
Elija Aplicación de consola (.NET Framework) y, a continuación, seleccione Siguiente.
En el nombre del proyecto, escriba
CreateADLApplication
y, a continuación, seleccione Crear.Agregue los paquetes NuGet al proyecto.
Haga clic con el botón derecho en el Explorador de soluciones y haga clic en Administrar paquetes de NuGet.
En la pestaña Administrador de paquetes NuGet, asegúrese de que la opción Origen del paquete esté establecida en nuget.org y que esté activada la casilla Incluir versión preliminar.
Busque e instale los siguientes paquetes NuGet:
Microsoft.Azure.Management.DataLake.Store
- En este tutorial se usa v2.1.3 (versión preliminar).Microsoft.Rest.ClientRuntime.Azure.Authentication
- En este tutorial se usa v2.2.12.
Cierre el Administrador de paquetes NuGet.
Abra Program.cs, elimine el código existente e incluya las siguientes instrucciones para agregar referencias a espacios de nombres.
using System; using System.IO; using System.Linq; using System.Text; using System.Threading; using System.Collections.Generic; using System.Security.Cryptography.X509Certificates; // Required only if you are using an Azure AD application created with certificates using Microsoft.Rest; using Microsoft.Rest.Azure.Authentication; using Microsoft.Azure.Management.DataLake.Store; using Microsoft.Azure.Management.DataLake.Store.Models; using Microsoft.IdentityModel.Clients.ActiveDirectory;
Declare las variables y proporcione los valores de los marcadores de posición. Además, asegúrese de que la ruta de acceso local y el nombre de archivo que proporcione existen en el equipo.
namespace SdkSample { class Program { private static DataLakeStoreAccountManagementClient _adlsClient; private static string _adlsAccountName; private static string _resourceGroupName; private static string _location; private static string _subId; private static void Main(string[] args) { _adlsAccountName = "<DATA-LAKE-STORAGE-GEN1-NAME>.azuredatalakestore.net"; _resourceGroupName = "<RESOURCE-GROUP-NAME>"; _location = "East US 2"; _subId = "<SUBSCRIPTION-ID>"; } } }
En las restantes secciones de este artículo, se puede ver cómo se utilizan los métodos .NET disponibles para realizar operaciones como la autenticación, la carga de archivos, etc.
Authentication
- Para la autenticación del usuario final para la aplicación, consulte End-user authentication with Data Lake Storage Gen1 using .NET SDK (Autenticación del usuario final con Data Lake Storage Gen1 mediante el SDK de .NET).
- Para la autenticación entre servicios para la aplicación, consulte Service-to-service authentication with Data Lake Storage Gen1 using .NET SDK (Autenticación entre servicios con Data Lake Storage Gen1 mediante el SDK de .NET).
Creación del objeto de cliente
El fragmento de código siguiente crea el objeto de cliente de la cuenta de Data Lake Storage Gen1, que se usa para emitir solicitudes de administración de cuentas para el servicio, como, por ejemplo, crear o eliminar una cuenta.
// Create client objects and set the subscription ID
_adlsClient = new DataLakeStoreAccountManagementClient(armCreds) { SubscriptionId = _subId };
Creación de una cuenta de Data Lake Storage Gen1
El fragmento de código siguiente crea una cuenta de Data Lake Storage Gen1 en la suscripción de Azure que proporcionó al crear el objeto de cliente de la cuenta de Data Lake Storage Gen1.
// Create Data Lake Storage Gen1 account
var adlsParameters = new DataLakeStoreAccount(location: _location);
_adlsClient.Account.Create(_resourceGroupName, _adlsAccountName, adlsParameters);
Enumerar todas las cuentas de Data Lake Storage Gen1 de una suscripción
Agregue el método siguiente a la definición de la clase. En el siguiente fragmento de código se enumeran todas las cuentas de Data Lake Storage Gen1 de una suscripción de Azure dada.
// List all Data Lake Storage Gen1 accounts within the subscription
public static List<DataLakeStoreAccountBasic> ListAdlStoreAccounts()
{
var response = _adlsClient.Account.List(_adlsAccountName);
var accounts = new List<DataLakeStoreAccountBasic>(response);
while (response.NextPageLink != null)
{
response = _adlsClient.Account.ListNext(response.NextPageLink);
accounts.AddRange(response);
}
return accounts;
}
Eliminación de una cuenta de Data Lake Storage Gen1
En el siguiente fragmento de código se elimina la cuenta de Data Lake Storage Gen1 que creó anteriormente.
// Delete Data Lake Storage Gen1 account
_adlsClient.Account.Delete(_resourceGroupName, _adlsAccountName);
Consulte también
- Filesystem operations on Data Lake Storage Gen1 using .NET SDK (Operaciones del sistema de archivos en Data Lake Storage Gen1 mediante el SDK de .NET).
- Data Lake Storage Gen1 .NET SDK Reference (Referencia del SDK de .NET de Data Lake Storage Gen1)