Connettore per Google BigQuery: funzionalità e impostazioni

Contenuto della pagina

Suggerimento: Per istruzioni su come creare la prima connessione a Google BigQuery e informazioni sull'utilizzo dei dati di BigQuery in Spotfire, vedere Accesso ai dati da Google BigQuery.

Caratteristiche del connettore

Quando si accede ai dati con il connettore per Google BigQuery sono disponibili le seguenti funzionalità.


Funzione	Supportato?
Metodi di caricamento	Importazione (interna alla memoria) Esterno (dati interni al database) Su richiesta
Query personalizzate	Sì
Procedure archiviate	No
Proprietà personalizzate della connessione	No
Single Sign-On con provider di identità	N/D
Creazione in Web Client	No
Incluso nella distribuzione Spotfire su Linux	Sì

Proprietà dell'origine dati

Di seguito sono riportate le proprietà dell'origine dati supportate che è possibile configurare quando si crea una connessione dati con il connettore per Google BigQuery.


Opzione	Descrizione
Progetto di fatturazione	Selezionare il progetto Google Cloud Platform a cui è imputato il pagamento per le query a BigQuery provenienti dalla connessione dati. Nota: l'impostazione della preferenza `ListAllProjects` determina se è possibile visualizzare i dati solo dal progetto di fatturazione selezionato o tutti i dati a cui si ha accesso in Google BigQuery (nei progetti di cui si è membri). Un amministratore può modificare la preferenza in Gestione amministrazione in Connettori > Google BigQuery > ListAllProjects. Se `ListAllProjects` è impostato su `False` e si desidera accedere ai dati di un progetto diverso dal progetto di fatturazione selezionato, selezionare Includi dati da progetti aggiuntivi e inserire l'ID progetto.
Includi dati da progetti aggiuntivi	Questa impostazione può essere utilizzata per due scopi: Se si desidera accedere ai dati di un progetto Google Cloud Platform di cui non si è membri, inserire l'ID progetto per accedere a tali dati. Se l'impostazione della preferenza `ListAllProjects` è impostata su `False` e si desidera accedere ai dati da un progetto diverso dal progetto di fatturazione selezionato, inserire l'ID progetto. Selezionare questa casella di controllo e quindi, nel campo di testo, inserire gli ID dei progetti da cui includere i dataset. Utilizzare la virgola per separare gli ID in caso di più progetti. Ad esempio: `example-project-id-1, example-project-id-2`
Abilita colonne ripetute	Opzione che permette di visualizzare e selezionare colonne ripetute nelle connessioni all'origine dati. per poter operare con le colonne ripetute in Spotfire è necessaria una conoscenza approfondita dei dati. Per ulteriori informazioni sul funzionamento delle colonne ripetute provenienti da BigQuery in Spotfire, vedere Colonne ripetute provenienti da Google BigQuery. La casella di controllo è deselezionata per impostazione predefinita. Le colonne ripetute non vengono elencate per la selezione nella finestra di dialogo Viste nella connessione. Nota: se si desidera accedere ai dati di Google Analytics con il connettore di BigQuery, è necessario abilitare le colonne ripetute nella connessione.
Mostra dati pubblici	Opzione che permette di visualizzare e selezionare dati da dataset pubblici di BigQuery nelle connessioni all'origine dati. La casella di controllo è deselezionata per impostazione predefinita. I dati provenienti da dataset pubblici di BigQuery non vengono elencati per la selezione nella finestra di dialogo Viste nella connessione. Quando si abilitano i dati pubblici, il caricamento delle tabelle dati nella finestra di dialogo Viste nella connessione può richiedere molto tempo. Suggerimento: gli amministratori Spotfire possono scegliere se rendere o meno disponibile l'opzione Mostra dati pubblici agli utenti. Per impedire agli utenti di selezionare dati pubblici, l'amministratore può accedere a Spotfire Administration Manager e impostare la preferenza di Google BigQuery `ShowPublicDataCheckBox` su `False`.
Uso di endpoint privati	Scegliere se utilizzare endpoint privati per connettersi a Google BigQuery. A tale scopo, fare clic sulla scheda Endpoint privati. Sono disponibili cinque endpoint privati che possono essere ottenuti dalle preferenze o personalizzati. Vedere Endpoint privati per Google BigQuery.

Tipi di dati supportati

Quando si imposta una connessione a un'origine dati esterna, Spotfire deve mappare i tipi di dati nell'origine dati ai tipi di dati in Spotfire. Il connettore Google BigQuery supporta i tipi di dati seguenti.


Tipo di dati database	Tipo di dati Spotfire
BYTES	Binary
GEOGRAPHY	Binary
BOOL	Boolean/Bool
NUMERIC	Currency/Decimal
DATE	Date
DATETIME	DateTime
INT64	LongInteger/Long
FLOAT64	Real/Double
STRING	String
TIME	Time

Funzioni supportate

Le funzioni supportate sono le funzioni che è possibile utilizzare quando si usano tabelle di dati interne al database, ad esempio per colonne calcolate ed espressioni personalizzate.

Nota: alcune funzioni supportate potrebbero non essere utilizzabili con il database in uso. Ciò dipende dalle funzioni disponibili nel database, che spesso variano in base alla versione e al tipo di database.

Il connettore Google BigQuery supporta le funzioni seguenti.


Tipo di funzione	Funzioni supportate
Funzioni aggregate	`AVG`, `COUNT`, `COUNTIF`, `LOGICAL_AND`, `LOGICAL_OR`, `MAX`, `MIN`, `STRING_AGG`, `SUM`
Funzioni aggregate approssimate	`APPROX_COUNT_DISTINCT`
Funzioni bit	`BIT_COUNT`
Conversione	`STRING`
Funzioni di date	`EXTRACT`, `DATE`, `DATE_ADD`, `DATE_SUB`, `DATE_DIFF`, `DATE_TRUNC`, `DATE_FROM_UNIX_DATE`, `FORMAT_DATE`, `PARSE_DATE`, `UNIX_DATE`
Funzioni DateTime	`DATETIME`, `DATETIME_ADD`, `DATETIME_SUB`, `DATETIME_DIFF`, `DATETIME_TRUNC`, `FORMAT_DATETIME`, `PARSE_DATETIME`
Funzioni geografiche	`ST_GEOGPOINT`, `ST_MAKELINE`, `ST_MAKEPOLYGON`, `ST_GEOGFROMGEOJSON`, `ST_GEOGFROMTEXT`, `ST_GEOGFROMWKB`, `ST_ASGEOJSON`, `ST_ASTEXT`, `ST_ASBINARY`, `ST_BOUNDARY`, `ST_CENTROID`, `ST_CLOSESTPOINT`, `ST_DIFFERENCE`, `ST_INTERSECTION`, `ST_SNAPTOGRID`, `ST_UNION`, `ST_X`, `ST_Y`, `ST_CONTAINS`, `ST_COVEREDBY`, `ST_COVERS`, `ST_DISJOINT`, `ST_DWITHIN`, `ST_EQUALS`, `ST_INTERSECTS`, `ST_INTERSECTSBOX`, `ST_TOUCHES`, `ST_WITHIN`, `ST_ISEMPTY`, `ST_ISCOLLECTION`, `ST_DIMENSION`, `ST_NUMPOINTS`, `ST_AREA`, `ST_DISTANCE`, `ST_LENGTH`, `ST_MAXDISTANCE`, `ST_PERIMETER`, `ST_UNION_AGG`
Funzioni hash	`FARM_FINGERPRINT`, `MD5`, `SHA1`, `SHA256`, `SHA512`
Funzioni JSON	`JSON_EXTRACT`, `JSON_EXTRACT_SCALAR`, `TO_JSON_STRING`
Funzioni matematiche	`ABS`, `SIGN`, `IS_INF`, `IS_NAN`, `IEEE_DIVIDE`, `RAND`, `SQRT`, `POW`, `POWER`, `EXP`, `LN`, `LOG`, LOG10, `GREATEST`, `LEAST`, `DIV`, `SAFE_DIVIDE`, `MOD`, `ROUND`, `TRUNC`, `CEIL`, `CEILING`, `FLOOR`, `COS`, `COSH`, `ACOS`, `ACOSH`, `SIN`, `SINH`, `ASIN`, `ASINH`, `TAN`, `TANH`, `ATAN`, `ATANH`, `ATAN2`
Operatori	`+`,`-`, `*`, `/`
Funzioni aggregate statistiche	`CORR`,`COVAR_POP`, `COVAR_SAMP`, `STDDEV_POP`, `STDDEV_SAMP`, `STDDEV`, `VAR_POP`, `VAR_SAMP`, `VARIANCE`
Funzioni stringa	`BYTE_LENGTH`, `CHAR_LENGTH`, `CHARACTER_LENGTH`, `CONCAT`, `ENDS_WITH`, `FROM_BASE64`, `FROM_BASE32`, `FROM_HEX`, `LENGTH`, `LPAD`, `LOWER`, `LTRIM`, `NORMALIZE`, `NORMALIZE_AND_CASEFOLD`, `REGEXP_CONTAINS`, `REGEXP_EXTRACT`, `REGEXP_REPLACE`, `REPLACE`, `REPEAT`, `REVERSE`, `RPAD`, `RTRIM`, `SAFE_CONVERT_BYTES_TO_STRING`, `STARTS_WITH`, `SUBSTR`, `TO_BASE32`, `TO_BASE64`, `TO_HEX`, `TRIM`
Funzioni temporali	`TIME`, `TIME_ADD`, `TIME_SUB`, `TIME_DIFF`, `TIME_TRUNC`, `FORMAT_TIME`, `PARSE_TIME`
Funzioni timestamp	`EXTRACT`, `STRING`, `TIMESTAMP`, `TIMESTAMP_ADD`, `TIMESTAMP_SUB`, `TIMESTAMP_DIFF`, `TIMESTAMP_TRUNC`, `FORMAT_TIMESTAMP`, `TIMESTAMP_SECONDS`, `TIMESTAMP_MILLIS`, `TIMESTAMP_MICROS`, `UNIX_SECONDS`, `UNIX_MILLIS`, `UNIX_MICROS`
Funzioni UUID	`GENERATE_UUID`