to_hb_results() methode

Saves an HCL dataframe to a Results table.

Opmerking

Het gebruik van de methode to_hb_results() vereist dat u ook een wachtwoordvariabele genaamd v_hb_token in het venster Variabelen in de HCL-scripteditor en een HighBond API-token toewijst als waarde voor de variabele. Voor meer informatie raadpleegt u Gebruik het venster Variabelen om een HCL-variabele te definiëren.

Syntaxis

dataframe_name.to_hb_results(table_id = Results_table_ID_number, column_names = {"column_name":"Results_display_name", "...n":"...n"}|dictionary_object, overwrite = Waar|Onwaar)

Parameters

Naam	Beschrijving
table_id = Results_table_ID_number	Het numerieke ID van de Resultaten-tabel.
column_names = {"column_name" : "Results_display_name", "...n" : "...n"} optioneel	Een koppeling tussen een kolomnaam in het dataframe en een weergavenaam voor het bijbehorende veld in Resultaten. Maak de toewijzing voor een of meer kolommen met behulp van een standaard Python-dictionary. U specificeert alleen een weergavenaam voor het veld in de bestemmingstabel van Resultaten. De onderliggende veldnaam in Resultaten blijft ongewijzigd.
column_names = dictionary_object optioneel	Een vooraf bestaand woordenboekobject dat een of meer kolomnamen in het dataframe koppelt aan weergavenamen voor de bijbehorende velden in Resultaten. Als alternatief voor het maken van de kolomtoewijzing in to_hb_results(), kunt u de toewijzing in een afzonderlijk woordenboek maken en alleen de naam van het woordenboek opgeven in to_hb_results(). Als u dezelfde set weergavenamen voor meerdere doeltabellen in Resultaten moet maken, is deze aanpak efficiënter. U specificeert alleen een weergavenaam voor het veld in de bestemmingstabel van Resultaten. De onderliggende veldnaam in Resultaten blijft ongewijzigd.
overschrijven = Waar \| Onwaar	Waar Opgeslagen gegevens overschrijven alle bestaande gegevens in de Resultaten-tabel. Onwaar Opgeslagen gegevens worden toegevoegd aan bestaande gegevens in de Resultaten-tabel. Als u de parameter weglaat, worden opgeslagen gegevens standaard toegevoegd.

Retourneert

Voor succes is de retourcode 202. Voor een fout, een foutmelding.

Voorbeelden

Dataframe opslaan in een Resultaten-tabel

U slaat het dataframe customer_summary op in de Resultaten-tabel met ID 587293. Alle bestaande records in de Resultaten-tabel worden overschreven.

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

Dataframe opslaan en veldweergavenamen maken in Resultaten

U slaat het dataframe customer_summary op in de Resultaten-tabel met ID 587293. Tegelijkertijd maakt u drie weergavenamen voor velden in de bestemmingstabel in Resultaten.

In Resultaten:

Het veld Nr. gebruikt de weergavenaam Klantnummer
Het veld Voornaam gebruikt de weergavenaam Voornaam
Het veld Achternaam gebruikt de weergavenaam Achternaam

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

Meerdere dataframes opslaan en veldweergavenamen maken met behulp van een vooraf bestaand woordenboek

U gebruikt één woordenboekobject ( display_names ) om dezelfde set weergavenamen in drie Resultaten-tabellen te maken.

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)

Opmerkingen

Gegevenstypetoewijzing

Wanneer u een HCL-dataframe opslaat in een tabel in Resultaten, worden de kolomgegevenstypen in het dataframe automatisch toegewezen aan veldgegevenstypen in de tabel:

Kolomgegevenstype in HCL-dataframe	Type veldgegevens in Resultaten-tabel
object	teken
Categorie	teken
int64	numeriek
float64	numeriek
datetime64[ns]	datumtijd
timedelta64[ns]	numeriek
bool	logisch

Automatische verwijdering van metagegevens en extra velden

Als een gegevensanalyseworkflow data heen en weer stuurt tussen Resultaten en Robots, worden metadata- en extras-velden in een HCL-dataframe automatisch verwijderd uit de gegevens die terug worden opgeslagen in Resultaten. De velden worden verwijderd, ongeacht of u het HCL-dataframe opslaat naar dezelfde tabel in Resultaten of naar een nieuwe tabel.

metadata en extras velden zijn door het systeem gegenereerde velden in Resultaten en zijn beveiligd. De inhoud in deze velden kan, indien bewerkbaar, alleen worden bewerkt in Resultaten. Om deze reden kunt u deze velden niet overschrijven of aanvullen vanuit Robots.