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 |
|
Query personalizzate | Sì |
Procedure archiviate | Sì |
Proprietà personalizzate della connessione | Sì |
Single Sign-On con provider di identità | Sì |
Creazione in Web Client | Sì |
Supportato in Linux Web Player | 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 Microsoft 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.
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.