Usare un progetto di database U-SQL per sviluppare un database U-SQL per Azure Data Lake
Importante
Azure Data Lake Analytics ritirato il 29 febbraio 2024. Altre informazioni con questo annuncio.
Per l'analisi dei dati, l'organizzazione può usare Azure Synapse Analytics o Microsoft Fabric.
Il database U-SQL fornisce viste strutturate su dati non strutturati e dati strutturati gestiti in tabelle. Fornisce inoltre un sistema di catalogo di metadati generale per organizzare dati strutturati e codice personalizzato. Il database è il concetto che raggruppa questi oggetti correlati.
Altre informazioni su database U-SQL e DDL (Data Definition Language).
Il progetto di database U-SQL è un tipo di progetto in Visual Studio che consente agli sviluppatori di sviluppare, gestire e distribuire database U-SQL in modo rapido e semplice.
Creare un progetto di database U-SQL
Strumenti Azure Data Lake per Visual Studio ha aggiunto un nuovo modello di progetto denominato progetto del database U-SQL dopo la versione 2.3.3000.0. Per creare un progetto U-SQL, selezionare File > Nuovo > progetto. Il progetto U-database SQL è disponibile nel nodo U-SQL di Azure Data Lake>.
Sviluppare oggetti di database U-SQL usando un progetto di database
Fare clic con il pulsante destro del mouse sul progetto di database U-SQL. Selezionare Aggiungi > nuovo elemento. È possibile trovare tutti i i nuovi tipi di oggetto supportati nella procedura guidata Aggiungi nuovo elemento.
Per un oggetto non assembly, ad esempio una funzione con valori di tabella, un nuovo script U-SQL viene creato dopo l'aggiunta di un nuovo elemento. È possibile iniziare a sviluppare l'istruzione DDL per l'oggetto nell'editor.
Per un oggetto assembly, lo strumento fornisce un editor dell'interfaccia utente descrittivo che consente di registrare l'assembly e distribuire file DLL e altri file. Di seguito viene illustrato come aggiungere una definizione di oggetto assembly al progetto di database U-SQL:
Aggiungere riferimenti al progetto C# che includano UDO/UDAG/UDF per il progetto di database U-SQL.
Nella visualizzazione di progettazione dell'assembly scegliere l'assembly a cui si fa riferimento dal menu a discesa Crea assembly da riferimento.
Aggiungere dipendenze gestite e altri file se presenti. Quando si aggiungono file, lo strumento usa il percorso relativo per assicurarsi di poter trovare gli assembly sia sul computer locale sia sul computer di compilazione in un momento successivo.
@_DeployTempDirectory è una variabile predefinita che punta lo strumento alla cartella di output della compilazione. Nella cartella di output della compilazione ogni assembly dispone di una sottocartella il cui nome fa riferimento a quello dell'assembly. Tutte le DLL e i file aggiuntivi si trovano in quella sottocartella.
Compilare un progetto di database U-SQL
L'output della compilazione di un progetto di database U-SQL è un pacchetto di distribuzione di database U-SQL, il cui nome contiene il suffisso .usqldbpack. Il pacchetto .usqldbpack è un file ZIP contenente tutte le istruzioni DDL in un singolo script U-SQL nella cartella DDL e tutte le DLL e i file aggiuntivi per gli assembly nella cartella Temp.
Altre informazioni su come creare un progetto di database U-SQL con la riga di comando di MSBuild e un'attività di compilazione Azure DevOps Services.
Distribuire un database U-SQL
Il pacchetto .usqldbpack può essere distribuito in un account locale o in un account Azure Data Lake Analytics usando Visual Studio o Deployment SDK.
Distribuire un database U-SQL in Visual Studio
È possibile distribuire un database U-SQL tramite un progetto di database U-SQL o un pacchetto .usqldbpack in Visual Studio.
Distribuire attraverso un progetto di database U-SQL
Fare clic con il pulsante destro del mouse sul progetto di database U-SQL, quindi selezionare Distribuisci.
Nella Distribuzione guidata U-database SQL selezionare l'account ADLA in cui si vuole distribuire il database. Gli account locali e gli account ADLA sono entrambi supportati.
Origine database viene compilato automaticamente e punta al pacchetto .usqldbpack nella cartella di output della compilazione del progetto.
Immettere un nome in Nome database per creare un database. Se esiste già un database con lo stesso nome nell'account Azure Data Lake Analytics, tutti gli oggetti definiti nel progetto di database vengono creati senza ricreare il database.
Per distribuire il database U-SQL selezionare Invia. Vengono caricate tutte le risorse, assembly e file aggiuntivi, e viene inviato un progetto U-SQL che include tutti gli strumenti DDL.
Distribuire attraverso un pacchetto di distribuzione database U-SQL
Aprire Esplora server. Espandere l'account Azure Data Lake Analytics in cui distribuire il database.
Fare clic con il pulsante destro del mouse o premere e tenere premuti database U-SQL e quindi scegliere Distribuisci database.
Impostare Database Source (Origine database) sul percorso del pacchetto di distribuzione del database U-SQL (file .usqldbpack).
Immettere il Nome database per creare un database. Se è presente un database con lo stesso nome già presente nell'account azure di destinazione Data Lake Analytics, tutti gli oggetti definiti nel progetto di database vengono creati senza ricreare il database.
Distribuire il database U-SQL usando l'SDK
PackageDeploymentTool.exe offre le interfacce di programmazione e della riga di comando che consentono di distribuire database U-SQL. L'SDK è incluso nel pacchetto NuGet U-SQL SDK, disponibile in build/runtime/PackageDeploymentTool.exe.
Riferimento a un progetto di database U-SQL
Un progetto U-SQL può fare riferimento a un progetto di database U-SQL. Il riferimento interessa due carichi di lavoro:
- Compilazione del progetto: configurare gli ambienti di database a cui viene fatto riferimento prima di compilare gli script U-SQL.
- Esecuzione locale nell'account (progetto locale): gli ambienti di database a cui viene fatto riferimento vengono distribuiti nell'account (progetto locale) prima dell'esecuzione dello script U-SQL. Ulteriori informazioni sulle esecuzioni locali e sulla differenza tra account (computer locale) e (progetto locale).
Come aggiungere un riferimento di database U-SQL
Fare clic con il pulsante destro del mouse sul progetto U-SQL in Esplora soluzioni, quindi scegliere Aggiungi riferimento al database U-SQL....
Configurare un riferimento al database da un progetto di database U-SQL nella soluzione corrente o in un file di pacchetto di database U-SQL.
Specificare un nome per il database.
