Guide de l'utilisateur du client Web Spotfire®

Accès aux données de Microsoft SQL Server

Vous pouvez vous connecter et accéder aux données des systèmes Microsoft SQL Server à l’aide du connecteur de données pour Microsoft SQL Server. Sur cette page, vous trouverez des informations sur les fonctionnalités, les paramètres disponibles et les éléments à garder à l'esprit lorsque vous travaillez avec des connexions de données de Microsoft SQL Server.

Contenu de la page

Fonctionnalités du connecteur

La fonctionnalité suivante est disponible lorsque vous accédez aux données à l’aide du connecteur pour Microsoft SQL Server.

Fonction Pris en charge ?
Méthodes de chargement
  • Importer (« in-memory »)
  • Externe (« in-database »)
  • À la demande
Requêtes personnalisées Oui
Procédures stockées Oui
Propriétés des connexions personnalisées Oui
Authentification unique à l’aide du fournisseur d'identité Oui
Création dans un client Web Oui
Prise en charge sur Linux Web Player Oui

Propriétés de source de données

Vous trouverez ci-dessous les propriétés de source de données prises en charge que vous pouvez configurer lors de la création d’une connexion de données à l’aide du connecteur pour Microsoft SQL Server.

Remarque : pour obtenir plus d'informations sur les propriétés et les paramètres correspondants dans le logiciel du pilote, consultez la documentation officielle de Microsoft sur le fournisseur de données .NET pour SQL Server.
Option Description
Serveur

Nom du serveur où se trouvent les données. Pour inclure un numéro de port, ajoutez-le directement après le nom en le faisant précéder d'une virgule. Pour inclure un nom d'instance, ajoutez-le directement après le nom du serveur en le faisant précéder d'une barre oblique inversée.

Exemple avec un numéro de port : MyDatabaseServer,1234

Exemple avec un nom d'instance : MyDatabaseServer\InstanceName

Base de données

Détermine la manière de sélectionner la base de données à laquelle accéder.

Sélectionner dans la liste

Faites votre sélection dans une liste de toutes les bases de données disponibles dans le menu déroulant Base de données. Le menu déroulant Base de données est rempli lorsque vous cliquez sur Se connecter.

Remarque : pour utiliser l'option Sélectionner dans la liste, vous devez avoir accès à la base de données par défaut de la source de données. La base de données par défaut est souvent appelée « principale ».

Entrer un nom

Entrez manuellement le nom de la base de données à laquelle vous voulez accéder.

Méthode d'authentification

Méthode d'authentification à utiliser pour se connecter à la base de données.

Authentification Windows

Si vous choisissez l'authentification Windows, par exemple Kerberos, le jeton d'accès de l'utilisateur connecté sera utilisé. Les utilisateurs dotés des droits d'accès appropriés à SQL Server peuvent se connecter et lire les données.

Les informations d'identification de domaine ne sont pas stockées dans le fichier d'analyse.

Authentification SQL Server

L'authentification de la base de données s'effectue par un utilisateur de base de données. Les informations d'identification de la base de données peuvent être stockées, non cryptées, dans le fichier d'analyse, grâce à un paramètre défini dans la boîte de dialogue Paramètres de la source de données. Les informations d'identification trouvées dans le fichier d'analyse seront utilisées pour l'authentification automatique de la base de données.

Si aucune information d'identification ni aucun profil d'informations d'identification ne figurent dans le fichier d'analyse, les utilisateurs ouvrant le fichier seront invités à saisir les informations d'identification de base de données.

Notez que le système n'invite pas l'utilisateur à entrer les informations d'identification en cas d'échec des informations d'identification intégrées dans le fichier d'analyse.

Active Directory - Intégré

[Cette méthode d'authentification n'est pas prise en charge si vous ouvrez la connexion de données dans un client Web Spotfire qui s'exécute sur un système Linux.]

Si vous utilisez Active Directory et que votre domaine est fédéré avec Azure Active Directory, vous pouvez vous connecter à la base de données Microsoft Azure SQL et vous authentifier à l'aide de vos informations d'identification Azure Active Directory connectées. Sélectionnez la méthode d'authentification Active Directory - Intégré.

Grâce à cette méthode d'authentification, les informations d'identification ne peuvent pas être enregistrées dans le fichier d'analyse.

Active Directory - Mot de passe

Entrez votre nom d'utilisateur principal et votre mot de passe Azure Active Directory pour l'authentification avec la base de données Microsoft Azure SQL.

Utilisez l'authentification Active Directory - Mot de passe uniquement pour vous connecter à la base de données Microsoft Azure SQL.

Fournisseur d’identité (OAuth2)

Utilisez un fournisseur d'identité, tel qu'Okta ou Keycloak, pour vous connecter. Lorsque vous ouvrez la connexion de données, une fenêtre de navigateur Web s'ouvre et vous pouvez vous connecter au moyen de la procédure de connexion du fournisseur d'identité.

Crypter

Cochez cette case pour demander le cryptage utilisé lors de la connexion à SQL Server. La case Crypter est cochée par défaut.

Faire confiance au serveur

[Uniquement applicable si la case Crypter est cochée.]

Si vous souhaitez utiliser le cryptage pour vous connecter à SQL Server sans certificat de serveur vérifiable (par exemple, s'il utilise un certificat autosigné), vous pouvez cocher cette case pour faire confiance au serveur et vous connecter sans validation du certificat de serveur.

Expiration de la connexion (s)

Durée maximale, en secondes, autorisée pour l'établissement d'une connexion à la base de données.

Vous pouvez également définir ce délai d'expiration en tant que préférence dans le gestionnaire d’administration, qui sera utilisé si vous ne définissez pas de délai d’expiration dans la boîte de dialogue de connexion.

Si vous définissez un délai d'expiration dans la boîte de dialogue de connexion, cette valeur remplacera les paramètres de la préférence dans le gestionnaire d’administration. Si vous ne spécifiez un délai d'expiration ni dans la boîte de dialogue de connexion ni dans les préférences, la valeur par défaut de 120 secondes sera utilisée.

Remarque : si vous définissez l'expiration de la connexion sur zéro, elle sera considérée comme n'ayant pas de délai d'expiration. C'est-à-dire qu'il n'y aura pas de délai maximal pour l'exécution de la commande. Cela n'est généralement pas recommandé.

Expiration de la commande (s)

Durée maximale, en secondes, autorisée pour l'exécution d'une commande.

Vous pouvez également définir ce délai d'expiration en tant que préférence dans le gestionnaire d’administration, qui sera utilisé si vous ne définissez pas de délai d’expiration dans la boîte de dialogue de connexion.

Si vous définissez un délai d'expiration dans la boîte de dialogue de connexion, cette valeur remplacera les paramètres de la préférence dans le gestionnaire d’administration. Si vous ne spécifiez un délai d'expiration ni dans la boîte de dialogue de connexion ni dans les préférences, la valeur par défaut de 1 800 secondes sera utilisée.

Remarque : si vous définissez l'expiration de la commande sur zéro, elle sera considérée comme n'ayant pas de délai d'expiration. C'est-à-dire qu'il n'y aura pas de délai maximal pour l'exécution de la commande. Cela n'est généralement pas recommandé.

Propriétés personnalisées pour les sources de données de connexion Microsoft SQL Server

Vous trouverez ci-dessous la liste par défaut des paramètres du pilote autorisés en tant que propriétés personnalisées dans les sources de données de connexion Microsoft SQL Server. Pour savoir comment modifier les propriétés personnalisées autorisées, consultez la rubrique Contrôle des propriétés autorisées.

Propriétés personnalisées autorisées par défaut

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

Types de données SQL Server

Lorsque vous paramétrez une connexion à une source de données externes, Spotfire doit mapper les types de données de cette source avec les types de données de Spotfire. Vous trouverez ci-dessous une liste des différents types de données pris en charge par Spotfire et les mappages de types de données appliqués lors de l'utilisation d'une base de données SQL Server.

Type de données SQL Server Type de données 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

Fonctions prises en charge

Les fonctions prises en charge sont celles que vous pouvez utiliser lorsque vous utilisez des tables de données « in-database », par exemple pour les colonnes calculées et les expressions personnalisées.

Remarque : certaines fonctions prises en charge peuvent ne pas être utilisables avec votre base de données. Cela dépend des fonctions disponibles dans la base de données, qui diffèrent souvent selon les versions et les types de base de données.

Voici les fonctions prises en charge par le connecteur Microsoft SQL Server.

Type de fonction Fonctions prises en charge
Date et heure Year, Quarter, Month, Week, Day, DayOfMonth, DayOfYear, DayOfWeek, Hour, Minute, Second, Millisecond
Conversion SN
Math Abs, ASin, ACos, ATan, Atn2, Ceiling, Cos, Sin, Tan, Cot, Exp, Floor, Log, Log10, Power, Sqrt, Square
Opérateurs +, -, *, /, %
Statistical Sum, Avg, Max, Min, Count, UniqueCount, Count_Big, Stdev, StdevP, Var, VarP
Text CharIndex, Len, Lower, Upper, LTrim, RTrim, Soundex, Reverse, Split

Utilisation des connexions de données Microsoft SQL Server

Les informations suivantes concernent plus précisément l'utilisation des données provenant d'une connexion Microsoft SQL Server dans Spotfire.

Télémétrie – Marquage de requête

Lors de l'établissement d'une connexion à l'aide du connecteur pour Microsoft SQL Server, le nom et le numéro de version de l'application Spotfire sont ajoutés à la chaîne de connexion en tant que balise de télémétrie.