Benutzerdefinierte Anweisungen in Cortex Analyst

Mit den benutzerdefinierten Anweisungen haben Sie eine größere Kontrolle über die Erstellung von SQL. Mit Hilfe von natürlicher Sprache können Sie Cortex Analyst genau mitteilen, wie SQL-Abfragen aus Ihrer semantischen YAML-Modelldatei generiert werden sollen. Verwenden Sie zum Beispiel benutzerdefinierte Anweisungen, um Cortex Analyst mitzuteilen, was Sie mit Leistung oder Geschäftsjahr meinen. Auf diese Weise können Sie die Genauigkeit des generierten SQL verbessern, indem Sie eine benutzerdefinierte Logik oder zusätzliche Elemente einbauen.

So funktionieren benutzerdefinierte Anweisungen

Cortex Analyst fügt das Feld custom_instructions in die Datei des semantischen Modells YAML ein. In diesem Feld können Sie definierende Änderungen oder Ergänzungen bei der Erstellung von SQL vornehmen.

Weitere Informationen über die Syntax des semantischen Modells finden Sie unter Cortex Analyst-Spezifikation des semantischen Modells.

Beispiele

Um mögliche Anwendungsfälle für benutzerdefinierte Anweisungen zu erkunden, betrachten Sie die folgenden Beispiele.

Formatieren der Datenausgabe

Stellen Sie sicher, dass alle Zahlen in der Ausgabe auf zwei Dezimalstellen gerundet werden.

Das Feld custom_instructions in der Datei des semantischen Modells YAML

custom_instructions: "Ensure that all numeric columns are rounded to 2 decimal points in the output."
Copy

Generierte SQL-Abfrage

SELECT
  ROUND(column_name, 2) AS column_name,
  ...
FROM
  your_table;
Copy

Prozentsätze anpassen

Multiplizieren Sie Prozent- oder Ratenberechnungen automatisch mit 100, um Konsistenz zu gewährleisten.

Das Feld custom_instructions in der Datei des semantischen Modells YAML

custom_instructions: "For any percentage or rate calculation, multiply the result by 100."
Copy

Generierte SQL-Abfrage

SELECT
  (column_a / column_b) * 100 AS percentage_rate,
  ...
FROM
  your_table;
Copy

Hinzufügen von Standardfiltern

Wenden Sie einen Filter an, wenn der Benutzer keinen angibt (z. B. standardmäßig das letzte Jahr).

Das Feld custom_instructions in der Datei des semantischen Modells YAML

custom_instructions: "If no date filter is provided, apply a filter for the last year."
Copy

Generierte SQL-Abfrage

SELECT
  ...
FROM
  your_table
WHERE
  date_column >= DATEADD(YEAR, -1, CURRENT_DATE);
Copy

Verknüpfung von Spaltenfiltern

Wenden Sie zusätzliche Filter auf verwandte Spalten an, die auf Benutzereingaben basieren.

Das Feld custom_instructions in der Datei des semantischen Modells YAML

custom_instructions: "If a filter is applied on column X, ensure that the same filter is applied to dimension Y."
Copy

Generierte SQL-Abfrage

SELECT
  ...
FROM
  your_table
WHERE
  column_x = 'filter_value' AND
  dimension_y = 'filter_value';
Copy

Best Practices

Seien Sie konkret.

Beschreiben Sie die Änderungen klar und deutlich, z. B. „Fügen Sie eine Spalte mit einem festen Wert von 42 hinzu“ oder „Fügen Sie eine Summenberechnung für Spalte X ein“.

Fangen Sie klein an.

Beginnen Sie mit einfachen Änderungen, wie dem Hinzufügen einer statischen Spalte oder von Standardfiltern, bevor Sie zu komplexeren Szenarien übergehen.

Zeigen Sie eine Vorschau der generierten SQL-Abfrage an.

Vergewissern Sie sich, dass die Anweisungen wie vorgesehen angewendet werden und dass die generierte SQL-Abfrage korrekt ist.

Iterieren Sie schrittweise.

Experimentieren Sie mit komplexeren Anwendungsfällen, je vertrauter Sie mit dem Feature werden.

Sprache: Deutsch