Freigeben über

Verwenden des Assistenten für den Beispiel-App-Generator zum Erstellen von Code zum Erfassen und Abfragen Ihrer Daten

  • Artikel

Der Assistent für den Beispiel-App-Generator ist ein Tool, mit dem Sie eine funktionierende App zum Erfassen und Abfragen Ihrer Daten in Ihrer bevorzugten Programmiersprache erstellen können. Der generierte Code verweist auf die relevanten SDK-Frameworks und ist auf Ihren Cluster und Ihre Daten zugeschnitten. Die App ist ein eigenständiges, ausführbares Beispiel, das veranschaulicht, wie Sie eine Clusterverbindung mit Authentifizierung herstellen, Verwaltungsaufgaben ausführen und Daten mithilfe des SDK erfassen und abfragen.

Sie können den generierten Code als Programmiergrundlage für Ihre eigenen Apps verwenden und ihn entsprechend ändern oder Codeabschnitte in Ihre eigenen Apps kopieren. Der Code enthält Kommentare mit Tipps, bewährten Methoden, Links zu Referenzmaterial und empfohlenen Aufgabenänderungen bei der Anpassung des Codes an Ihre Anforderungen.

Voraussetzungen

Hinweis

Informationen zum Aktivieren des Zugriffs zwischen einem Cluster und einem Speicherkonto ohne öffentlichen Zugriff (auf privaten Endpunkt/Dienstendpunkt beschränkt) finden Sie unter Erstellen eines verwalteten privaten Endpunkts für Azure Data Explorer.

Zugreifen auf den Assistenten

Der Assistent für den Beispiel-App-Generator führt Sie durch die Erfassung.

So greifen Sie über die Azure Data Explorer-Web-Benutzeroberfläche auf den Assistenten zu:

  1. Wählen Sie im Bereich auf der linken Seite Abfrage aus.

  2. Klicken Sie mit der rechten Maustaste auf die gewünschte Tabelle, und wählen Sie "Beispielcode generieren">aus.

    Screenshot der Beispiel-App-Generator-Karte aus dem Tabellenkontextmenü.

Generieren einer Beispiel-App

In diesem Abschnitt werden die allgemeinen Optionen des Assistenten beschrieben. Die ausgewählten Optionen hängen davon ab, aus welchem Datenformat Sie aufnehmen, von welcher Art von Datenquelle Sie aufnehmen, und ob Sie eine neue oder vorhandene Tabelle aufnehmen.

Der Assistent führt Sie durch die folgenden Optionen:

Destination

Gehen Sie in der Registerkarte Ziel folgendermaßen vor:

  1. Wählen Sie den Cluster und die Datenbank aus.

  2. Wählen Sie aus, ob eine vorhandene Tabelle oder eine neue Tabelle verwendet werden soll. Wählen Sie für eine vorhandene Tabelle die Tabelle aus den Optionen aus. Geben Sie der Tabelle für eine neue Tabelle einen Namen.

  3. Wählen Sie die Programmiersprache für Ihre App aus.

    Screenshot der Azure Data Explorer-Web-UI mit der Zielregisterkarte des Beispiel-App-Generators.

  4. Wählen Sie die Option Weiter: Quelle aus.

Quelle

Auf der Registerkarte Quelle:

  1. Wählen Sie aus den folgenden Optionen:

    • Abfrage und Erfassung: Laden Sie Daten für die Aufnahme hoch und empfangen Sie den entsprechenden Code für die Erfassung und Abfrage der angegebenen Daten.
    • Nur Abfrage: Rufen Sie den Code ab, um die tabelle abzufragen, die auf der vorherigen Registerkarte ausgewählt ist.

  2. Wenn Sie "Abfrage und Aufnahme" ausgewählt haben, wählen Sie die Quelldatei oder das BLOB für die Aufnahme aus.

  3. Wählen Sie die Option Weiter: Schema aus.

Schema

Auf der Registerkarte "Schema " generiert der Dienst automatisch Schema- und Aufnahmeeigenschaften, die Sie nach Bedarf ändern können. So richten Sie das Schema ein:

  1. Bestätigen Sie den automatisch generierten Komprimierungstyp.

  2. Wählen Sie das Datenformat aus den Formaten aus, die vom Azure-Daten-Explorer für die Aufnahme unterstützt werden. Unterschiedliche Formate weisen unterschiedliche Spezifikationen auf.

  3. Passen Sie im Fenster "Teildatenvorschau " das Schema nach Bedarf an. Wählen Sie dazu den Pfeil oben in einer Spalte aus, um ein Menü mit Optionen zum Ändern des Datentyps zu öffnen, eine neue Spalte zu erstellen, eine Spalte zu löschen und vieles mehr. Wenn Ihre Daten im Format "Parkett", "JSON" oder "Avro" vorliegen, können Sie Zuordnungstransformationen anwenden.

    Screenshot zum Öffnen der Schemaanpassungsoptionen.

  4. Wählen Sie "Weiter" aus: Beispiel-App generieren.

Tipp

Um die von Ihren Eingaben generierten Befehle anzuzeigen, zu bearbeiten und zu kopieren, öffnen Sie den Befehlsanzeiger über dem Fenster "Teildatenvorschau ".

Zuordnungstransformationen

Parkett-, JSON- und Avro-Datenformate unterstützen einfache Aufnahmezeittransformationen. Um Zuordnungstransformationen anzuwenden, erstellen oder aktualisieren Sie eine Spalte im Fenster " Teildatenvorschau ".

Zuordnungstransformationen können für eine Spalte vom Typ "String" oder "datetime" ausgeführt werden, wobei die Quelldaten den Datentyp "int" oder "long" aufweisen. Die folgenden Zuordnungstransformationen werden unterstützt:

  • DateTimeFromUnixSeconds
  • DateTimeFromUnixMilliseconds
  • DateTimeFromUnixMicroseconds
  • DateTimeFromUnixNanoseconds

Weitere Informationen finden Sie unter Zuordnungstransformationen.

Generate

Nachdem Sie die Schemazuordnung und Spaltenmanipulation abgeschlossen haben, startet der Assistent für den Beispiel-App-Generator den Codegenerierungsprozess. Nach der Codegenerierung kann das Beispiel-App-Projekt als ZIP-Datei heruntergeladen werden.

Detaillierte Anweisungen zum Ausführen des Projekts mit dem ausgewählten SDK werden bei erfolgreicher Generierung und in der Beispielprojektdatei bereitgestellt. Darüber hinaus bietet ihnen der Assistent Optionen, schnelle Abfragen für die erste Erkundung Ihrer Daten zu verwenden.

Hinweis

Möglicherweise müssen Sie die heruntergeladene App ausführen, damit die Schnellabfragen funktionieren.

Zugehöriger Inhalt