to_hb_results()-Methode

Speichert einen HCL-Datenrahmen in eine Ergebnisse-App-Tabelle.

Hinweis

Die Verwendung der Methode to_hb_results() erfordert, dass Sie auch eine Kennwortvariable namens v_hb_token im Fenster Variablen des HCL-Skript-Editors erstellen und einen HighBond-API-Token als Variablenwert zuweisen. Weitere Informationen finden Sie unter HCL-Variablen werden im Fenster „Variablen“ definiert..

Syntax

datenrahmen_name.to_hb_results(table_id = Ergebnistabellen_ID_nummer, column_names = {"spaltenname":"Ergebnisanzeigename", "...n":"...n"}|dictionary_objekt, overwrite = True|False)

Parameter

Name	Beschreibung
table_id = Ergebnistabellen_ID_nummer	Die numerische ID der Ergebnistabelle.
column_names = {"spaltenname" : "Ergebnisanzeigename", "...n" : "...n"} Optional	Eine Zuordnung zwischen einem Spaltennamen im Datenrahmen und einem Anzeigenamen für das entsprechende Feld in „Ergebnisse“. Erstellen Sie die Zuordnung für eine oder mehrere Spalten mit einem standardmäßigen Python-Dictionary. Sie geben den Anzeigenamen nur für das Feld in der Zielergebnistabelle an. Der Name des zugrunde liegenden Feldes in „Ergebnisse“ bleibt gleich.
column_names = dictionary_objekt Optional	Ein bereits vorhandenes Dictionary-Objekt, das Spaltennamen im Datenrahmen Anzeigenamen für die entsprechenden Felder in „Ergebnisse“ zuordnet. Als Alternative zur Erstellung einer Spaltenzuordnung in to_hb_results() können Sie die Zuordnung in einem separaten Dictionary erstellen und nur den Dictionary-Namen in to_hb_results() angeben. Wenn Sie dieselben Anzeigenamen für mehrere Zieltabellen in „Ergebnisse“ erstellen müssen, ist dieser Ansatz effizienter. Sie geben den Anzeigenamen nur für das Feld in der Zielergebnistabelle an. Der Name des zugrunde liegenden Feldes in „Ergebnisse“ bleibt gleich.
overwrite = True \| False	True Gespeicherte Daten überschreiben bestehende Daten innerhalb der Ergebnisse-App-Tabelle. False Gespeicherte Daten werden an bestehende Daten der Ergebnisse-App-Tabelle angehängt. Wenn der Parameter weggelassen wird, werden gespeicherte Daten standardmäßig angehängt.

Gibt zurück

Im Erfolgsfall lautet der Rückgabecode 202. Bei einem Fehler wird die Fehlermeldung ausgegeben.

Beispiele

Datenrahmen in eine Ergebnisse-App-Tabelle speichern

Sie speichern den Datenrahmen customer_summary in die Ergebnisse-App-Tabelle mit der ID 587293. Bestehende Datensätze in der Ergebnisse-App-Tabelle werden überschrieben.

customer_summary.to_hb_results(table_id = "587293", overwrite = True)

Datenrahmen speichern und Feldanzeigenamen in „Ergebnisse“ erstellen

Sie speichern den Datenrahmen customer_summary in die Ergebnisse-App-Tabelle mit der ID 587293. Gleichzeitig erstellen Sie drei Anzeigenamen für Felder in der Zielergebnistabelle.

In der Ergebnisse-App:

Das Feld No verwendet den Anzeigenamen Customer Number.
Das Feld First verwendet den Anzeigenamen First Name.
Das Feld Last verwendet den Anzeigenamen Last Name.

customer_summary.to_hb_results(table_id = "587293", column_names = {"No":"Customer Number", "First":"First Name", "Last":"Last Name"}, overwrite = True)

Mehrere Datenrahmen speichern und Feldanzeigenamen mit einem bereits vorhandenen Dictionary erstellen

Sie verwenden ein einzelnes Dictionary-Objekt (display_names), um dieselben Anzeigenamen in drei Ergebnistabellen zu erstellen.

display_names = {"No":"Customer Number", "First":"First Name", "Last":"Last Name"}
customer_summary_us.to_hb_results(table_id = "587293", column_names = display_names, overwrite = True)
customer_summary_eu.to_hb_results(table_id = "587294", column_names = display_names, overwrite = True)
customer_summary_ap.to_hb_results(table_id = "587295", column_names = display_names, overwrite = True)

Bemerkungen

Zuordnung von Datentypen

Wenn Sie einen HCL-Datenrahmen in einer Tabelle in „Ergebnisse“ speichern, werden Spaltendatentypen im Datenrahmen automatisch den Felddatentypen in der Tabelle zugeordnet:

Spaltendatentyp in HCL-Datenrahmen	Felddatentyp in Ergebnistabelle
Objekt	Zeichen
Kategorie	Zeichen
int64	numerisch
float64	numerisch
datetime64[ns]	Datumzeit
timedelta64[ns]	numerisch
bool	logisch

Automatisches Entfernen der Felder „metadata“ und „extras“

Wenn ein Datenanalyse-Workflow Daten von „Ergebnisse“ zu Robots und wieder zurück zu „Ergebnisse“ leitet, werden die Felder metadata und extras in einem HCL-Datenrahmen automatisch aus den Daten entfernt, die in „Ergebnisse“ gespeichert werden. Die Felder werden unabhängig davon entfernt, ob Sie den HCL-Datenrahmen wieder in derselben Tabelle in „Ergebnisse“ oder in einer neuen Tabelle speichern.

Die Felder metadata und extras werden vom System in „Ergebnisse“ generiert und sind geschützt. Wenn der Inhalt dieser Felder bearbeitbar ist, kann er nur in „Ergebnisse“ bearbeiten werden. Aus diesem Grund können Sie diese Felder nicht aus Robots überschreiben oder ergänzen.