Usare la procedura guidata del generatore di app di esempio per creare codice per inserire ed eseguire query sui dati

  • Articolo

La procedura guidata del generatore di app di esempio è uno strumento che consente di creare un'app funzionante per inserire ed eseguire query sui dati nel linguaggio di programmazione preferito. Il codice generato fa riferimento ai framework SDK pertinenti ed è personalizzato per il cluster e i dati. L'app è un esempio eseguibileautonomo che illustra come connettersi a un cluster usando l'autenticazione, l'amministrazione e l'inserimento e la query dei dati usando l'SDK.

È possibile usare il codice generato come linea di base per scrivere app personalizzate, modificando il codice durante il passaggio oppure copiando le sezioni di codice nelle proprie app. Il codice include commenti con suggerimenti, procedure consigliate, collegamenti al materiale di riferimento e modifiche consigliate toDO durante l'adattamento del codice alle proprie esigenze.

Prerequisiti

Nota

Per abilitare l'accesso tra un cluster e un account di archiviazione senza accesso pubblico (limitato all'endpoint privato/endpoint servizio), vedere Creare un endpoint privato gestito.

Accedere alla procedura guidata

La procedura guidata del generatore di app di esempio illustra il processo di inserimento.

Per accedere alla procedura guidata dall'interfaccia utente Web di Azure Esplora dati:

  1. Selezionare Query nel riquadro sinistro.

  2. Fare clic con il pulsante destro del mouse sulla tabella desiderata e scegliere Genera>codice di esempio.

    Screenshot che mostra la scheda generatore di app di esempio dal menu di scelta rapida della tabella.

Generare un'app di esempio

Questa sezione descrive la procedura guidata in generale. Le opzioni selezionate dipendono dal formato dei dati da inserire, dal tipo di origine dati da cui si esegue l'inserimento e dal fatto che si stia inseriti in una tabella nuova o esistente.

Questa procedura guidata illustra le opzioni seguenti:

Destination

Nella scheda Destinazione :

  1. Selezionare cluster e database.

  2. Scegliere se usare una tabella esistente o una tabella Nuova. Per una tabella esistente, selezionare la tabella dalle opzioni. Per una nuova tabella, assegnare alla tabella un nome.

  3. Selezionare il linguaggio di programmazione per l'app.

    Screenshot dell'interfaccia utente Web di Azure Esplora dati che mostra la scheda Destinazione del generatore di app di esempio.

  4. Selezionare Avanti: Origine.

Source

Nella scheda Origine :

  1. È possibile scegliere una delle opzioni seguenti:

    • Query e inserimento: caricare i dati per l'inserimento e ricevere il codice corrispondente per l'inserimento e l'esecuzione di query sui dati specificati.
    • Solo query: ottenere il codice per eseguire query sulla tabella selezionata nella scheda precedente.

  2. Se è stata selezionata Query e inserimento, selezionare il file di origine o il BLOB per l'inserimento.

  3. Selezionare Avanti: Schema.

SCHEMA

Nella scheda Schema il servizio genera automaticamente proprietà di schema e inserimento, che è possibile modificare in base alle esigenze. Per configurare lo schema:

  1. Confermare il tipo di compressione generato automaticamente.

  2. Scegliere il formato dati dai formati supportati da Azure Esplora dati per l'inserimento. I formati diversi hanno specifiche diverse.

  3. Nella finestra Anteprima dati parziale modificare lo schema in base alle esigenze. A tale scopo, selezionare la freccia nella parte superiore di una colonna per aprire un menu con opzioni per modificare il tipo di dati, creare una nuova colonna, eliminare una colonna e altro ancora. Se i dati sono in formato Parquet, JSON o Avro, è possibile applicare trasformazioni di mapping.

    Screenshot di come aprire le opzioni di regolazione dello schema.

  4. Selezionare Avanti: Generare un'app di esempio.

Suggerimento

Per visualizzare, modificare e copiare i comandi generati dagli input, aprire il visualizzatore comandi sopra la finestra Anteprima dati parziale .

Trasformazioni del mapping

I formati di dati Parquet, JSON e Avro supportano trasformazioni semplici ingest-time. Per applicare trasformazioni di mapping, creare o aggiornare una colonna nella finestra Anteprima dati parziale .

Le trasformazioni di mapping possono essere eseguite su una colonna di tipo stringa o datetime, con i dati di origine con tipo di dati int o long. Le trasformazioni del mapping supportate sono:

  • DateTimeFromUnixSeconds
  • DateTimeFromUnixMilliseconds
  • DateTimeFromUnixMicroseconds
  • DateTimeFromUnixNanoseconds

Per altre informazioni, vedere Trasformazioni di mapping.

Generate

Dopo aver completato il mapping dello schema e le manipolazioni delle colonne, la procedura guidata del generatore di app di esempio avvia il processo di generazione del codice. Dopo la generazione di codice, il progetto dell'app di esempio sarà disponibile per il download come file ZIP.

Le istruzioni dettagliate per l'esecuzione del progetto con l'SDK selezionato vengono fornite al termine della generazione e all'interno del file di progetto di esempio. Inoltre, la procedura guidata offre opzioni per usare query rapide per l'esplorazione iniziale dei dati.

Nota

Potrebbe essere necessario eseguire l'app scaricata per il funzionamento delle query rapide .

Contenuti correlati