Guida per l'utente di TIBCO Cloud™ Spotfire® Web Client

Accesso ai dati da Microsoft SQL Server

È possibile connettersi e accedere ai dati provenienti da sistemi Microsoft SQL Server utilizzando il connettore dati per Microsoft SQL Server. In questa pagina sono illustrate le funzionalità, le impostazioni disponibili e gli aspetti da considerare quando si utilizza una connessioni dati a Microsoft SQL Server.

Contenuto della pagina

Caratteristiche del connettore

Quando si accede ai dati con il connettore per Microsoft SQL Server sono disponibili le seguenti funzionalità.

Funzione Supportato?
Metodi di caricamento
  • Importazione (interna alla memoria)
  • Esterno (dati interni al database)
  • Dati su richiesta
Query personalizzate
Procedure archiviate
Proprietà personalizzate della connessione
Single Sign-On con provider di identità
Creazione in Web Client
Supportato in Linux Web Player

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 Microsoft SQL Server.

Nota: per ulteriori informazioni sulle proprietà e sulle impostazioni corrispondenti nel software del driver, consultare la documentazione ufficiale di Microsoft sul provider di dati .NET per SQL Server.
Opzione Descrizione
Server

Il nome del server in cui sono posizionati i dati. Per includere il numero di una porta, aggiungerlo direttamente dopo il nome preceduto da virgola. Per includere il nome di un'istanza, aggiungerlo direttamente dopo il nome del server preceduto da una barra rovesciata.

Esempio con il numero di una porta: MyDatabaseServer,1234

Esempio con il nome di un'istanza: MyDatabaseServer\InstanceName

Database

Determina la modalità di selezione del database a cui accedere.

Seleziona nell'elenco

Effettuare la selezione dall'elenco di tutti i database disponibili elencati nel menu a discesa Database. Il menu a discesa Database viene popolato dopo aver fatto clic su Connetti.

Nota: per utilizzare l'opzione Seleziona nell'elenco, è necessario avere accesso al database predefinito nell'origine dati. Il database predefinito è spesso chiamato "master".

Inserisci il nome

Inserire manualmente il nome del database a cui si desidera accedere.

Metodo di autenticazione

Il metodo di autenticazione da utilizzare quando si accede al database.

Autenticazione Windows

Se si utilizza l'autenticazione Windows, ad es. Kerberos, sarà utilizzato il token di accesso dell'utente che ha effettuato l'accesso. Gli utenti a cui sono stati forniti i diritti di accesso appropriati a SQL Server potranno connettersi e leggere i dati.

Le credenziali del dominio non sono memorizzate nel file analisi.

Autenticazione SQL Server

Con l'autenticazione del database, l'autenticazione viene effettuata tramite un utente del database. Le credenziali del database possono essere memorizzate in maniera non crittografata nell'ambito del file analisi utilizzando un'impostazione della finestra di dialogo Impostazioni origine dati. Se le credenziali si trovano nel file analisi, saranno utilizzate per l'autenticazione automatica al database.

Se nel file analisi non sono presenti credenziali o profili delle credenziali, a tutti coloro che aprono il file verranno richieste le credenziali per il database.

Le credenziali non saranno richieste qualora quelle integrate nel file analisi non funzionino.

Active Directory - Integrata

[Questo metodo di autenticazione non è supportato se si apre la connessione dati in un client Web Spotfire in esecuzione su un sistema Linux.]

Se si utilizza Active Directory e il dominio è federato con Azure Active Directory, è possibile connettersi al database SQL di Microsoft Azure ed effettuare l'autenticazione utilizzando le credenziali di accesso ad Azure Active Directory. Selezionare il metodo di autenticazione Active Directory - Integrata.

Con questo metodo di autenticazione non è possibile salvare le credenziali nel file di analisi.

Active Directory - Password

Inserire il nome utente e la password dell'utente principale di Azure Active Directory per effettuare l'autenticazione con il database SQL di Microsoft Azure.

Utilizzare l'autenticazione Active Directory - Password solo per stabilire la connessione al database SQL di Microsoft Azure.

Provider di identità (OAuth2)

Utilizzare un provider di identità, come Okta o Keycloak, per eseguire l'accesso. All'apertura della connessione dati, si apre una finestra del browser Web e si accede mediante la procedura di accesso del provider di identità.

Crittografa

Selezionare questa casella di controllo per richiedere l'uso della crittografia durante la connessione a SQL Server. Per impostazione predefinita, l'opzione Crittografa è selezionata.

Considera server attendibile

[Applicabile solo quando è selezionata l'opzione Crittografa].

Se si desidera utilizzare la crittografia per effettuare la connessione a un SQL Server che non dispone di un certificato server verificabile (ad esempio se utilizza un certificato autofirmato), è possibile selezionare questa casella di controllo per considerare attendibile il server ed effettuare la connessione senza la convalida del certificato server.

Timeout connessione (s)

Tempo massimo in secondi consentito per stabilire una connessione al database.

Questo timeout può essere impostato come preferenza anche in Gestione amministrazione, che verrà utilizzata se non si imposta un timeout nella finestra di dialogo di connessione.

Se si imposta un timeout nella finestra di dialogo di connessione, questo valore sovrascriverà le impostazioni nella preferenza di Gestione amministrazione. Se non si specifica un timeout né nella finestra di dialogo di connessione né nella preferenza, verrà utilizzato il valore predefinito di 120 secondi.

Nota: se il timeout della connessione è impostato su zero, è come se non ci fosse timeout. Questo significa che non ci sono limiti massimi di tentativi di esecuzione del comando. Si tratta di un'opzione generalmente non consigliata.

Timeout comando (s)

Tempo massimo, espresso in secondi, consentito per l'esecuzione di un comando.

Questo timeout può essere impostato come preferenza anche in Gestione amministrazione, che verrà utilizzata se non si imposta un timeout nella finestra di dialogo di connessione.

Se si imposta un timeout nella finestra di dialogo di connessione, questo valore sovrascriverà le impostazioni nella preferenza di Gestione amministrazione. Se non si specifica un timeout né nella finestra di dialogo di connessione né nella preferenza, verrà utilizzato il valore predefinito di 1800 secondi.

Nota: se il timeout del comando è impostato su zero, è come se non ci fosse timeout. Questo significa che non ci sono limiti massimi di tentativi di esecuzione del comando. Si tratta di un'opzione generalmente non consigliata.

Proprietà personalizzate per origini dati di connessione di Microsoft SQL Server

Di seguito è riportato l'elenco predefinito delle impostazioni del driver consentite come proprietà personalizzate nelle origini dati di connessione di Microsoft SQL Server. Per informazioni su come modificare le proprietà personalizzate consentite, vedere Controllo delle proprietà consentite.

Proprietà personalizzate consentite predefinite

ApplicationIntent, Attestation Protocol, Column Encryption Setting, ConnectRetryCount, ConnectRetryInterval, Enclave Attestation Url, Enlist, Failover Partner, FailoverPartnerSPN, HostNameInCertificate, IPAddressPreference, Load Balance MultiSubnetFailoverTimeout, Max Pool Size, Min Pool Size, MultipleActiveResultSets, , Packet Size, PoolBlockingPeriod, Pooling, ServerCertificate, ServerSPN, Transaction Binding, Type System Version, User Instance, Workstation ID

Tipi di dati SQL Server

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. Di seguito è riportato un elenco dei diversi tipi di dati supportati da Spotfire e le mappature dei tipi di dati applicate quando si lavora con un database SQL Server.

Tipo di dati di SQL Server Tipo di dati Spotfire
BINARY Binary
GEOGRAPHY Binary
GEOMETRY Binary
IMAGE Binary
ROWVERSION Binary
TIMESTAMP Binary
VARBINARY Binary
BIT Boolean
DECIMAL Currency
MONEY Currency
NUMERIC Currency
SMALLMONEY Currency
DATE Date
DATETIME DateTime
DATETIME2 DateTime
SMALLDATETIME DateTime
INT Integer
SMALLINT Integer
TINYINT Integer
BIGINT LongInteger
FLOAT Real
REAL SingleReal
CHAR String
NCHAR String
NTEXT String
NVARCHAR String
TEXT String
UNIQUEIDENTIFIER String
VARCHAR 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 Microsoft SQL Server supporta le funzioni seguenti.

Tipo di funzione Funzioni supportate
Data e ora Year, Quarter, Month, Week, Day, DayOfMonth, DayOfYear, DayOfWeek, Hour, Minute, Second, Millisecond
Conversione SN
Matematica Abs, ASin, ACos, ATan, Atn2, Ceiling, Cos, Sin, Tan, Cot, Exp, Floor, Log, Log10, Power, Sqrt, Square
Operatori +, -, *, /, %
Statistica Sum, Avg, Max, Min, Count, UniqueCount, Count_Big, Stdev, StdevP, Var, VarP
Testo CharIndex, Len, Lower, Upper, LTrim, RTrim, Soundex, Reverse, Split

Lavorare con le connessioni dati di Microsoft SQL Server

Di seguito sono riportate informazioni specifiche sull'utilizzo con dati provenienti da una connessione Microsoft SQL Server in Spotfire.

Telemetria: tag di query

Quando si stabilisce una connessione utilizzando il connettore per Microsoft SQL Server, alla stringa di connessione vengono aggiunti il nome dell'applicazione Spotfire e il numero di versione come tag di telemetria.