Metodo publish()
Viene salvato un dataframe HCL in un set di dati del Centro attività.
Sintassi
hcl.publish(dataframe_name, table_name = AC_dataset_name, column_names = {"column_name":"dataset_display_name", "...n":"...n"}|dictionary_object, append = True|False)
AC = Centro attività
Parametri
| Nome | Descrizione |
|---|---|
| dataframe_name |
Il nome del dataframe Pandas o HCL da salvare in Centro attività. Tutte le colonne nel dataframe vengono salvate. Se si desidera salvare solo una selezione delle colonne, creare prima un dataframe configurato in modo appropriato, prima di usare publish(). |
| table_name = AC_dataset_name |
Il nome del set di dati del Centro attività. Nota Esaminare i nomi dei set di dati esistenti in Centro attività e assicurarsi di specificare un nome unico per il set di dati. Il metodo publish() non impedisce di specificare un nome di set di dati duplicato, il che può creare una situazione di confusione in Centro attività. |
| column_names = {"column_name" : "dataset_display_name", "...n" : "...n"} facoltativo |
Una mappatura tra un nome di colonna nel dataframe e un nome visualizzato per il campo corrispondente nel set di dati di Centro attività. Costruire la mappatura per una o più colonne utilizzando un dizionario Python standard. Si sta specificando un nome visualizzato solo per il campo nel set di dati di Centro attività di destinazione. Il nome del campo sottostante in Centro attività rimane invariato. È possibile scegliere di specificare i nomi di visualizzazione solo per un sottoinsieme di colonne. Le colonne senza nome di visualizzazione specificato utilizzano il nome della colonna del dataframe in Centro attività. Il parametro column_names non seleziona le colonne da salvare. Per impostazione predefinita, il metodo publish() salva tutte le colonne del dataframe in Centro attività. Nota Assicurarsi che i nomi di visualizzazione specificati siano univoci. Il metodo publish() non impedisce di specificare un nome di visualizzazione duplicato. Tuttavia, la pubblicazione su Centro attività non riesce. Per maggiori informazioni, consultare Il nome delle colonne e di visualizzazione devono essere univoci. |
| column_names = dictionary_object facoltativo |
Un oggetto dizionario preesistente che mappa uno o più nomi di colonna nel dataframe per visualizzare i nomi dei campi corrispondenti in Risultati. In alternativa alla creazione della mappatura delle colonne all'interno di publish(), è possibile creare la mappatura in un dizionario separato e specificare solo il nome del dizionario all'interno di publish(). Se è necessario creare lo stesso set di nomi visualizzati per più set di dati di destinazione in Centro attività, questo approccio è più efficiente. Le linee guida che si applicano quando si crea un dizionario all'interno di publish() si applicano anche quando si crea un dizionario separato. |
| ascending = True | False |
Se si omette il parametro, i dati salvati sovrascrivono tutti i dati esistenti per impostazione predefinita. |
Restituisce
In caso di esito positivo, il codice di ritorno 204. In caso di errore, un messaggio di errore.
Il codice di ritorno 204 significa che Robot ha inviato correttamente i dati a Centro attività. Anche la successiva elaborazione dei dati in Centro attività deve avvenire correttamente prima che i dati inviati da Robot siano disponibili come set di dati in Centro attività.
Esempi
Salvare un dataframe in un set di dati del Centro attività
Si salva il dataframe customer_summary in un set di dati di Centro attività denominato Customer. Se il set di dati Customer esiste già in Centro attività, i record esistenti vengono sovrascritti.
hcl.publish(customer_summary, table_name = "Customer")
Osservazioni
Il nome delle colonne e di visualizzazione devono essere univoci
Per pubblicare correttamente i dati da Robot a Centro attività, i nomi delle colonne del dataframe devono essere univoci. Un nome di colonna duplicato in un dataframe causa il fallimento del metodo publish() con un messaggio di errore.
Se si specificano i nomi di visualizzazione per i campi di un set di dati del Centro attività, anche i nomi di visualizzazione devono essere univoci. Un nome di visualizzazione duplicato non causa il fallimento del metodo publish() e uno script contenente il metodo viene eseguito fino al completamento. Tuttavia, l'elaborazione successiva dei dati non riesce e la pubblicazione nel Centro attività non va a buon fine.
Ambito della capacità di pubblicazione
Le autorizzazioni di scrittura per i set di dati del Centro attività creati da Robot sono basate sul robot. Per aggiornare un set di dati, è necessario utilizzare lo stesso robot che ha creato inizialmente il set di dati. Il metodo publish() non supporta l'attraversamento dei confini dei robot durante l'aggiornamento dei set di dati.
Aggiunta automatica della data e dell'ora di pubblicazione
Il metodo publish() include automaticamente la data e l'ora di pubblicazione con i dati inviati a Centro attività. Quando si aggiungono i dati come una tabella a un'analisi e a una dashboard in Centro attività, includere il campo Pubblicato alle ore per visualizzare la data e l'ora di pubblicazione più recente, aggiornata dinamicamente, per ogni record della tabella.
Queste informazioni sulla marca temporale sono utili per verificare che una pubblicazione pianificata da Robot sia stata eseguita alla data e all'ora previste. Se si aggiungono record a un set di dati, le informazioni sulla marca temporale mostrano anche quando ogni record è stato aggiunto e permettono di ordinare per marca temporale.
