Partager via


Propriétés XMLA prises en charge (XMLA)

Microsoft SQL Server Analysis Services prend en charge les propriétés répertoriées dans le tableau suivant. Vous utilisez ces propriétés dans l'élément Properties des méthodes Discover et Execute.

Nom

Élément

AxisFormat

Utilisation

Propriété String facultative, en écriture seule

Description

Détermine le format utilisé dans un ensemble de résultats MDDataSet pour décrire les axes du dataset multidimensionnel. Cette propriété peut adopter l'une des valeurs répertoriées dans le tableau suivant.

Valeur

Description

ClusterFormat

L'axe MDDataSet est composé d'un ou plusieurs éléments CrossProduct.

CustomFormat

Analysis Services utilise le format TupleFormat pour ce paramètre.

TupleFormat

(Valeur par défaut) L'axe MDDataSet contient un ou plusieurs éléments Tuple.

Cette propriété peut s'utiliser avec la méthode Execute.

BeginRange

Utilisation

Propriété Integer facultative, en écriture seule

Description

Contient une valeur entière de base zéro qui correspond à une valeur d'attribut CellOrdinal. (L'attribut CellOrdinal fait partie de l'élément Cell dans la section CellData de MDDataSet.)

L'application cliente peut utiliser cette propriété conjointement avec la propriété EndRange pour restreindre un dataset OLAP retourné par une commande à une plage de cellules spécifique. Si -1 est spécifié, toutes les cellules jusqu'à la cellule spécifiée dans la propriété EndRange sont retournées.

La valeur par défaut de cette propriété est -1.

Cette propriété peut s'utiliser avec la méthode Execute.

Catalog

Utilisation

Propriété String facultative, en lecture/écriture

Description

Lors de l'établissement d'une session avec une instance Analysis Services pour envoyer une commande XMLA, cette propriété est équivalente à la propriété OLE DB DBPROP_INIT_CATALOG.

Lorsque vous la définissez au cours d'une session pour modifier la base de données actuelle de la session, cette propriété est équivalente à la propriété OLE DB DBPROP_CURRENTCATALOG.

La valeur par défaut de cette propriété est une chaîne vide.

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

CatalogLocation

Utilisation

Propriété Integer facultative, en lecture seule

Description

Cette propriété est équivalente à la propriété OLE DB DBPROP_CATALOGLOCATION.

La valeur par défaut de cette propriété est zéro (0), ce qui équivaut à DBPROPVAL_CL_START.

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

ClientProcessID

Utilisation

Propriété Integer facultative, en lecture/écriture

Description

Contient l'identificateur (ID) du thread de processus pour la session active.

La valeur par défaut de cette propriété est zéro (0).

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

CommitTimeout

Utilisation

Propriété Integer facultative, en écriture seule

Description

Détermine le délai d'attente, exprimé en secondes, observé dans la phase de validation d'une commande XMLA en cours d'exécution avant d'effectuer une restauration. La phase de validation correspond à des commandes XMLA telles que Statement ou Process.

Une valeur de zéro (0) indique que l'instance attend indéfiniment.

La valeur par défaut de cette propriété est zéro (0).

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

Content

Utilisation

Propriété String facultative, en écriture seule

Description

Détermine le type des données retournées par les méthodes Discover et Execute. Cette propriété peut adopter l'une des valeurs répertoriées dans le tableau suivant.

Valeur

Description

None

Permet de vérifier la structure de la commande sans l'exécuter.

Schema

Retourne le schéma XML relatif à la commande demandée. Le schéma XML précise les colonnes et fournit d'autres informations.

Data

Retourne uniquement les données demandées.

SchemaData

(Valeur par défaut) Retourne les informations du schéma et les données.

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

Cube

Utilisation

Propriété String facultative, en écriture seule

Description

Contient le nom du cube qui définit le contexte de la commande. Si la commande elle-même contient un nom de cube, ce qui est par exemple le cas dans la clause FROM d'une instruction MDX (Multidimensional Expressions) SELECT, la valeur de cette propriété est ignorée.

La valeur par défaut de cette propriété est une chaîne vide.

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

DataSourceInfo

Utilisation

Propriété String requise, en lecture/écriture

Description

Contient les informations requises pour se connecter à la source de données, par exemple le nom de l'instance.

Les applications clientes ne doivent pas construire le contenu de la propriété DataSourceInfo à envoyer à une instance. À la place, l'application cliente doit rechercher les sources de données prises en charge par le fournisseur en utilisant la méthode Discover pour récupérer l'ensemble de lignes DISCOVER_DATASOURCES. L'application cliente renvoie ensuite pour la propriété DataSourceInfo la valeur que le client a extraite de l'ensemble de lignes DISCOVER_DATASOURCES.

Cette propriété ne possède pas de valeur par défaut.

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

DbpropCatalogTerm

Utilisation

Propriété String facultative, en lecture seule

Description

Cette propriété est équivalente à la propriété OLE DB DBPROP_CATALOGTERM.

La valeur par défaut de cette propriété est « Database ».

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

DbpropCatalogUsage

Utilisation

Propriété Integer facultative, en lecture seule

Description

Cette propriété est équivalente à la propriété OLE DB DBPROP_CATALOGUSAGE.

La valeur par défaut de cette propriété est zéro (0).

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

DbpropColumnDefinition

Utilisation

Propriété Integer facultative, en lecture seule

Description

Cette propriété est équivalente à la propriété OLE DB DBPROP_COLUMNDEFINITION.

La valeur par défaut de cette propriété est zéro (0).

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

DbpropConcatNullBehavior

Utilisation

Propriété Integer facultative, en lecture seule

Description

Cette propriété est équivalente à la propriété OLE DB DBPROP_CONCATNULLBEHAVIOR.

La valeur par défaut de cette propriété est 1, ce qui équivaut à DBPROPVAL_CB_NULL.

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

DbpropDataSourceReadOnly

Utilisation

Propriété Boolean facultative, en lecture seule

Description

Cette propriété est équivalente à la propriété OLE DB DBPROP_DATASOURCEREADONLY.

La valeur par défaut de cette propriété est FALSE.

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

DbpropGroupBy

Utilisation

Propriété Integer facultative, en lecture seule

Description

Cette propriété est équivalente à la propriété OLE DB DBPROP_GROUPBY.

La valeur par défaut de cette propriété est 2, ce qui équivaut à DBPROPVAL_GB_EQUALS_SELECT.

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

DbpropHeterogeneousTables

Utilisation

Propriété Integer facultative, en lecture seule

Description

Cette propriété est équivalente à la propriété OLE DB DBPROP_HETEROGENEOUSTABLES.

La valeur par défaut de cette propriété est zéro (0).

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

DbpropIdentifierCase

Utilisation

Propriété Integer facultative, en lecture seule

Description

Cette propriété est équivalente à la propriété OLE DB DBPROP_IDENTIFIERCASE.

La valeur par défaut de cette propriété est 8, ce qui équivaut à DBPROPVAL_IC_MIXED.

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

DbpropInitMode

Utilisation

Propriété Integer facultative, en lecture/écriture

Description

Cette propriété est équivalente à la propriété OLE DB DBPROP_INIT_MODE.

Les seules valeurs prises en charge pour cette propriété sont DB_MODE_READWRITE et DB_MODE_READ.

Cette propriété ne possède pas de valeur par défaut.

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

DbpropMaxIndexSize

Utilisation

Propriété Integer facultative, en lecture seule

Description

Cette propriété est équivalente à la propriété OLE DB DBPROP_MAXINDEXSIZE.

La valeur par défaut de cette propriété est zéro (0).

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

DbpropMaxOpenChapters

Utilisation

Propriété Integer facultative, en lecture seule

Description

Cette propriété est équivalente à la propriété OLE DB DBPROP_MAXOPENCHAPTERS.

La valeur par défaut de cette propriété est zéro (0).

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

DbpropMaxRowSize

Utilisation

Propriété Integer facultative, en lecture seule

Description

Cette propriété est équivalente à la propriété OLE DB DBPROP_MAXROWSIZE.

La valeur par défaut de cette propriété est zéro (0).

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

DbpropMaxRowSizeIncludeBlob

Utilisation

Propriété Boolean facultative, en lecture seule

Description

Cette propriété est équivalente à la propriété OLE DB DBPROP_MAXROWSIZEINCLUDESBLOB.

La valeur par défaut de cette propriété est TRUE.

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

DbpropMaxTablesInSelect

Utilisation

Propriété Integer facultative, en lecture seule

Description

Cette propriété est équivalente à la propriété OLE DB DBPROP_MAXTABLESINSELECT.

La valeur par défaut de cette propriété est 1.

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

DbpropMsmdAutoexists

Utilisation

Propriété Integer facultative, en lecture/écriture

Description

Détermine le comportement de la fonctionnalité autoexist. Cette propriété peut adopter l'une des valeurs répertoriées dans le tableau suivant.

Valeur

Description

0

Valeur par défaut, égale à 1.

1

Applique les fonctionnalités autoexist profondes pour les axes de requête et les jeux nommés. Inclut des clauses WHERE et des instructions de sous-sélection.

2

Applique les fonctionnalités autoexist profondes pour les axes de requête et exclut les jeux nommés des fonctionnalités autoexist. Inclut des clauses WHERE et des instructions de sous-sélection.

3

N'applique aucune fonctionnalité autoexist pour les jeux nommés avec la clause WHERE. Applique des fonctionnalités autoexist superficielles pour les axes de requête avec la clause WHERE. Applique des fonctionnalités autoexist profondes pour les axes de requête avec des instructions de sous-sélection et pour les jeux nommés avec des instructions de sous-sélection.

Les valeurs par défaut de cette propriété sont zéro ou vide.

Il s'agit d'une propriété de session qui ne peut être définie que lors de la création de la session.

DbpropMsmdCacheMode

Utilisation

Propriété Integer facultative, en lecture/écriture

Description

Réservée pour un usage ultérieur.

Cette propriété ne possède pas de valeur par défaut.

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

DbpropMsmdCachePolicy

Utilisation

Propriété Integer facultative, en lecture/écriture

Description

Réservée pour un usage ultérieur.

Cette propriété ne possède pas de valeur par défaut.

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

DbpropMsmdCacheRatio

Utilisation

Propriété Integer facultative, en lecture/écriture

Description

Réservée pour un usage ultérieur.

Cette propriété ne possède pas de valeur par défaut.

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

DbpropMsmdCacheRatio2

Utilisation

Propriété Double facultative, en lecture/écriture

Description

Réservée pour un usage ultérieur.

Cette propriété ne possède pas de valeur par défaut.

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

DbpropMsmdCompareCaseNotSensitiveStringFlags

Utilisation

Propriété Integer facultative, en lecture/écriture

Description

Détermine une comparaison des chaînes respectant la casse et des fonctionnalités d'ordre de tri. Cette propriété précise les modalités selon lesquelles les comparaisons s'effectuent dans les jeux de caractères qui ne prennent pas en charge les majuscules et les minuscules, par exemple le katakana pour le japonais et l'hindi. La valeur de cette propriété est définie dans la première connexion du thread de processus et affecte toutes les connexions suivantes dans ce thread de processus.

Utilisez le tableau suivant pour déterminer les indicateurs à utiliser.

Nom

Valeur

Description

NORM_IGNORECASE

0x00000001

La casse est ignorée.

Non applicable

0x00000002

Comparaison binaire. Les caractères sont comparés en fonction de leur valeur sous-jacente dans le jeu de caractères et non selon leur ordre dans leur alphabet particulier.

NORM_IGNORENONSPACE

0x00000010

Les caractères sans espace sont ignorés.

NORM_IGNORESYMBOLS

0x00000100

Les symboles sont ignorés.

NORM_IGNOREKANATYPE

0x00001000

Aucune distinction n'est faite entre les caractères japonais hiragana et katakana. Lors des comparaisons, les caractères hiragana et katakana correspondants sont considérés comme égaux.

NORM_IGNOREWIDTH

0x00010000

Aucune distinction n'est faite entre les versions du même caractère codées sur un octet et sur deux octets.

SORT_STRINGSORT

0x00100000

La ponctuation est traitée de la même façon que les symboles.

Pour plus d'informations sur la comparaison de chaînes dans OLE DB, recherchez « CompareString » dans la section Platform SDK de MSDN Library (en anglais).

Cette propriété ne possède pas de valeur par défaut.

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

DbpropMsmdCompareCaseSensitiveStringFlags

Utilisation

Propriété Integer facultative, en lecture/écriture

Description

Détermine une comparaison de chaînes ne respectant pas la casse et des fonctionnalités d'ordre de tri. Cette propriété précise les modalités selon lesquelles les comparaisons s'effectuent dans les jeux de caractères qui ne prennent pas en charge les majuscules et les minuscules, par exemple le katakana pour le japonais et l'hindi. La valeur de cette propriété est définie dans la première connexion du thread de processus et affecte toutes les connexions suivantes dans ce thread de processus.

Utilisez le tableau suivant pour déterminer les indicateurs à utiliser.

Nom

Valeur

Description

NORM_IGNORECASE

0x00000001

La casse est ignorée.

Non applicable

0x00000002

Comparaison binaire. Les caractères sont comparés en fonction de leur valeur sous-jacente dans le jeu de caractères et non selon leur ordre dans leur alphabet particulier.

NORM_IGNORENONSPACE

0x00000010

Les caractères sans espace sont ignorés.

NORM_IGNORESYMBOLS

0x00000100

Les symboles sont ignorés.

NORM_IGNOREKANATYPE

0x00001000

Aucune distinction n'est faite entre les caractères japonais hiragana et katakana. Lors des comparaisons, les caractères hiragana et katakana correspondants sont considérés comme égaux.

NORM_IGNOREWIDTH

0x00010000

Aucune distinction n'est faite entre les versions du même caractère codées sur un octet et sur deux octets.

SORT_STRINGSORT

0x00100000

La ponctuation est traitée de la même façon que les symboles.

Pour plus d'informations sur la comparaison de chaînes dans OLE DB, recherchez « CompareString » dans la section Platform SDK de MSDN Library (en anglais).

Cette propriété ne possède pas de valeur par défaut.

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

DbpropMsmdDebugMode

Utilisation

Propriété String facultative, en lecture/écriture

Description

Réservée pour un usage ultérieur.

Cette propriété ne possède pas de valeur par défaut.

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

DbpropMsmdDynamicDebugLimit

Utilisation

Propriété Integer facultative, en lecture/écriture

Description

Réservée pour un usage ultérieur.

Cette propriété ne possède pas de valeur par défaut.

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

DbpropMsmdFlattened2

Utilisation

Propriété Boolean facultative, en lecture/écriture

Description

Fournit tous les membres d'une hiérarchie parent-enfant dans une seule colonne de table dans le résultat aplati, sauf si la hiérarchie parent-enfant est demandée sur l'axe 0. Le modèle de niveau pour les colonnes de sortie n'est pas utilisé.

La valeur par défaut de cette propriété est FALSE.

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

DbpropMsmdMDXCompatibility

Utilisation

Propriété Integer facultative, en lecture/écriture

Description

Détermine comment les membres d'espace réservé d'une hiérarchie déséquilibrée sont traités. Cette propriété peut adopter l'une des valeurs répertoriées dans le tableau suivant.

Valeur

Description

0

Pour assurer la compatibilité avec les versions antérieures de Analysis Services, cette valeur est équivalente à 1

1

Les hiérarchies dans les dimensions de rôle actif reçoivent une légende qui contient le nom de dimension et le nom de hiérarchie. La légende a le format suivant :

[Dimension].[Hiérarchie]

Les membres d'espace réservé sont exposés.

2

Les hiérarchies dans les dimensions de rôle actif reçoivent une légende qui contient le nom de dimension et le nom de hiérarchie. La légende a le format suivant :

[Dimension].[Hiérarchie]

Les membres d'espace réservé ne sont pas exposés.

3

(Valeur par défaut) Les membres d'espace réservé ne sont pas exposés.

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

DbpropMsmdMDXUniqueNameStyle

Utilisation

Propriété Integer facultative, en lecture/écriture

Description

Détermine l'algorithme employé pour générer les noms uniques des membres dans une dimension. Cette propriété peut adopter l'une des valeurs répertoriées dans le tableau suivant.

Valeur

Description

0

Pour assurer la compatibilité avec les versions antérieures de Analysis Services, cette valeur est équivalente à 2.

1

Utilise un algorithme générant des chemins d'accès basés sur les clés :

[dim].&[clé1].&[clé2]

2

Utilise un algorithme générant des chemins d'accès basés sur les noms :

[dim].[nom1].&[nom2]

3

Utilise des noms dont l'unicité est garantie et qui ne changent pas dans le temps.

La valeur par défaut de cette propriété est 6.

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

DbpropMsmdSQLCompatibility

Utilisation

Propriété Integer facultative, en lecture/écriture

Description

Réservée pour un usage ultérieur.

La valeur par défaut de cette propriété est zéro (0).

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

DbpropMsmdSubQueries

Utilisation

Propriété Integer facultative, en lecture/écriture

Description

Masque de bits qui détermine le comportement des sous-requêtes. Cette propriété peut adopter l'une des valeurs répertoriées dans le tableau suivant.

Valeur

Description

0

Valeur par défaut, compatible avec les versions antérieures de Analysis Services.

Les membres calculés ou ensembles calculés ne sont pas autorisés dans les sous-sélections ou les sous-cubes.

1

Les membres calculés ou ensembles calculés sont autorisés dans les sous-sélections ou les sous-cubes. Les ascendants du membre calculé ne sont pas inclus dans l'espace de la sous-sélection ou du sous-cube.

2

Les membres calculés ou ensembles calculés sont autorisés dans les sous-sélections ou les sous-cubes. Les ascendants du membre calculé sont inclus dans l'espace de la sous-sélection ou du sous-cube.

Les valeurs par défaut de cette propriété sont zéro ou vide.

Il s'agit d'une propriété de session qui ne peut être définie que lors de la création de la session.

Consultez Membres calculés dans les sous-sélections et les sous-cubes pour obtenir une explication détaillée du comportement de membres calculés ou ensembles calculés dans les sous-sélections et les sous-cubes.

DbpropMsmdUseFormulaCache

Utilisation

Propriété String facultative, en lecture/écriture

Description

Réservée pour un usage ultérieur.

Cette propriété ne possède pas de valeur par défaut.

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

DbpropMultiTableUpdate

Utilisation

Propriété Boolean facultative, en lecture seule

Description

Cette propriété est équivalente à la propriété OLE DB DBPROP_MULTITABLEUPDATE.

La valeur par défaut de cette propriété est FALSE.

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

DbpropNullCollation

Utilisation

Propriété Integer facultative, en lecture seule

Description

Cette propriété est équivalente à la propriété OLE DB DBPROP_NULLCOLLATION.

La valeur par défaut de cette propriété est 4, ce qui équivaut à DBPROPVAL_NC_LOW.

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

DbpropOrderByColumnsInSelect

Utilisation

Propriété Boolean facultative, en lecture seule

Description

Cette propriété est équivalente à la propriété OLE DB DBPROP_ORDERBYCOLUMNSINSELECT.

La valeur par défaut de cette propriété est FALSE.

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

DbpropOutputParameterAvailable

Utilisation

Propriété Integer facultative, en lecture seule

Description

Cette propriété est équivalente à la propriété OLE DB DBPROP_OUTPUTPARAMETERAVAILABILITY.

La valeur par défaut de cette propriété est 1, ce qui équivaut à DBPROPVAL_OA_NOTSUPPORTED.

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

DbpropPersistentIdType

Utilisation

Propriété Integer facultative, en lecture seule

Description

Cette propriété est équivalente à la propriété OLE DB DBPROP_PERSISTENTIDTYPE.

La valeur par défaut de cette propriété est 4, ce qui équivaut à DBPROPVAL_PT_NAME.

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

DbpropPrepareAbortBehavior

Utilisation

Propriété Integer facultative, en lecture seule

Description

Cette propriété est équivalente à la propriété OLE DB DBPROP_PREPAREABORTBEHAVIOR.

La valeur par défaut de cette propriété est 1, ce qui équivaut à DBPROPVAL_CB_DELETE.

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

DbpropPrepareCommitBehavior

Utilisation

Propriété Integer facultative, en lecture seule

Description

Cette propriété est équivalente à la propriété OLE DB DBPROP_PREPARECOMMITBEHAVIOR.

La valeur par défaut de cette propriété est 1, ce qui équivaut à DBPROPVAL_CB_DELETE.

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

DbpropProcedureTerm

Utilisation

Propriété String facultative, en lecture seule

Description

Cette propriété est équivalente à la propriété OLE DB DBPROP_PROCEDURETERM.

La valeur par défaut de cette propriété est « Calculated member ».

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

DbpropQuotedIdentifierCase

Utilisation

Propriété Integer facultative, en lecture seule

Description

Cette propriété est équivalente à la propriété OLE DB DBPROP_QUOTEDIDENTIFIERCASE.

La valeur par défaut de cette propriété est 8, ce qui équivaut à DBPROPVAL_IC_MIXED.

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

DbpropSchemaUsage

Utilisation

Propriété Integer facultative, en lecture seule

Description

Cette propriété est équivalente à la propriété OLE DB DBPROP_SCHEMAUSAGE.

La valeur par défaut de cette propriété est zéro (0).

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

DbpropSqlSupport

Utilisation

Propriété Integer facultative, en lecture seule

Description

Cette propriété est équivalente à la propriété OLE DB DBPROP_SQLSUPPORT.

La valeur par défaut de cette propriété est 512, ce qui équivaut à DBPROPVAL_SQL_SUBMINIMUM.

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

DbpropSubqueries

Utilisation

Propriété Integer facultative, en lecture seule

Description

Cette propriété est équivalente à la propriété OLE DB DBPROP_SUBQUERIES.

[!REMARQUE]

Alors que le langage DMX (Data Mining Extensions) prend en charge les sous-requêtes, cette propriété fait référence à la prise en charge des sous-requêtes dans SQL.

La valeur par défaut de cette propriété est zéro (0).

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

DbpropSupportedTxnDdl

Utilisation

Propriété Integer facultative, en lecture seule

Description

Cette propriété est équivalente à la propriété OLE DB DBPROP_SUPPORTEDTXNDDL.

La valeur par défaut de cette propriété est zéro (0), ce qui équivaut à DBPROPVAL_TC_NONE.

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

DbpropSupportedTxnIsoLevels

Utilisation

Propriété Integer facultative, en lecture seule

Description

Cette propriété est équivalente à la propriété OLE DB DBPROP_SUPPORTEDTXNISOLEVELS.

La valeur par défaut de cette propriété est 4096, ce qui équivaut à DBPROPVAL_TI_READCOMMITTED.

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

DbpropSupportedTxnIsoRetain

Utilisation

Propriété Integer facultative, en lecture seule

Description

Cette propriété est équivalente à la propriété OLE DB DBPROP_SUPPORTEDTXNISORETAIN.

La valeur par défaut de cette propriété est 292, ce qui équivaut à une combinaison de DBPROPVAL_TR_ABORT_NO, DBPROPVAL_TR_COMMIT_NO et DBPROPVAL_TR_NONE.

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

DbpropTableTerm

Utilisation

Propriété String facultative, en lecture seule

Description

Cette propriété est équivalente à la propriété OLE DB DBPROP_TABLETERM.

La valeur par défaut de cette propriété est « Cube ».

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

Dialect

Utilisation

Propriété String facultative, en lecture/écriture

Description

Établit le dialecte utilisé dans les situations suivantes :

  • Le dialecte que le fournisseur utilisera la première fois qu'il essaiera d'exécuter une requête.

  • Le dialecte utilisé pour les erreurs d'exécution retournées comme résultat d'échecs de requête.

Les dialectes disponibles pour cette propriété sont répertoriés dans le tableau suivant.

Nom

Valeur

Description

DBGUID_SQL

C8B522D7-5CF3-11CE-ADE5-00AA0044773D

L'analyseur SQL a la priorité.

MDGUID_DM

62C58FED-CCA5-44F1-83B6-7B45682B3904

L'analyseur DMX a la priorité.

MDGUID_MDX

A07CCCD0-8148-11D0-87BB-00C04FC33942

L'analyseur MDX a la priorité.

Vous pouvez utiliser la propriété Dialect lorsque vous vous attendez à ce que la plupart des requêtes utilisent un dialecte particulier plutôt que les autres.

La syntaxe de requête peut être semblable dans les dialectes des langages tels que DMX et SQL. C'est pourquoi il est possible que Analysis Services ne soit pas en mesure d'inférer le dialecte de la syntaxe de requête. Si une requête ne fonctionne pas dans un dialecte, l'instance Analysis Services peut essayer d'exécuter à nouveau cette requête dans un dialecte différent.

Si la propriété Dialect est définie, Analysis Services retourne les erreurs d'exécution de la requête dans le dialecte qui a la priorité, même si le fournisseur essaie de réexécuter la requête dans un autre dialecte. Supposons par exemple que la propriété Dialect ait la valeur MDGUID_DM. Le fournisseur essaie d'abord d'exécuter la requête comme une requête d'exploration de données, mais cette tentative échoue. Ensuite, le fournisseur soumet à nouveau la requête, cette fois en tant que requête SQL. Toutefois, cette requête SQL échoue également. Comme la valeur de la propriété Dialect est MDGUID_DM, Analysis Services retourne un message d'erreur d'exploration de données et non un message d'erreur SQL.

Si la propriété Dialect n'est pas définie, Analysis Services retourne les erreurs d'exécution de la requête dans le dialecte utilisé en dernier. Supposons par exemple qu'une requête d'exploration de données échoue alors que la propriété Dialect n'est pas définie. Ensuite, le fournisseur soumet à nouveau la requête, en tant que requête SQL. La requête SQL échoue également. Comme la propriété Dialect n'est pas définie, le fournisseur retourne alors un message d'erreur SQL et non un message d'erreur d'exploration de données.

Cette propriété ne possède pas de valeur par défaut.

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

Désactiver les faits de prérécupération

Utilisation

Propriété Boolean facultative, en lecture/écriture,

Description

En cas de définition sur la valeur True, le moteur cesse toute tentative de prérécupération des valeurs pour la longueur de la session.

La valeur par défaut de cette propriété est False.

EffectiveRoles

Utilisation

Propriété String facultative, en écriture seule

Description

Réservée pour un usage ultérieur.

Cette propriété ne possède pas de valeur par défaut.

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

EffectiveUserName

Utilisation

Propriété String facultative, en écriture seule

Description

Spécifie le nom d'un compte à utiliser pour remplacer le nom d'utilisateur lors de la connexion à une instance Analysis Services. La valeur de cette propriété n'est pas normalisée dans la mesure où la fonction MDX UserName retourne la valeur littérale si cette propriété est utilisée. Cette propriété peut être utilisée uniquement par les administrateurs de serveur.

Cette propriété prend en charge les types SID suivants : User, Group, Alias, WellKnownGroup et Computer.

Cette propriété ne possède pas de valeur par défaut.

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

EndRange

Utilisation

Propriété Integer facultative, en écriture seule

Description

Spécifie une valeur entière de base zéro qui correspond à une valeur d'attribut CellOrdinal. (L'attribut CellOrdinal fait partie de l'élément Cell dans la section CellData de MDDataSet.)

L'application cliente peut utiliser cette propriété conjointement avec la propriété BeginRange pour restreindre un dataset OLAP retourné par une commande à une plage de cellules spécifique. Si -1 est spécifié, toutes les cellules à partir de la cellule spécifiée dans la propriété BeginRange sont retournées.

La valeur par défaut de cette propriété est -1.

Cette propriété peut s'utiliser avec la méthode Execute.

ExecutionMode

Utilisation

Propriété String facultative, en écriture seule

Description

Réservée pour un usage ultérieur.

La valeur par défaut de cette propriété est Execute.

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

ForceCommitTimeout

Utilisation

Propriété Integer facultative, en écriture seule

Description

Détermine le délai d'attente, exprimé en secondes, observé dans la phase de validation d'une commande XMLA en cours d'exécution avant de forcer les commandes soumises antérieurement à effectuer une restauration. La phase de validation correspond à des commandes XMLA telles que Statement ou Process.

Une valeur de zéro (0) indique que l'instance attend indéfiniment.

La valeur par défaut de cette propriété est zéro (0).

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

Format

Utilisation

Propriété String facultative, en écriture seule

Description

Détermine le type d'ensemble de résultats retourné par les méthodes Discover et Execute. Cette propriété peut adopter l'une des valeurs répertoriées dans le tableau suivant.

Valeur

Description

Tabular

Retourne un ensemble de résultats à l'aide du type de données Rowset.

Multidimensional

Retourne un ensemble de lignes à l'aide du type de données MDDataSet.

Native

Aucun format n'est spécifié explicitement. Analysis Services retourne le format approprié pour la commande. Le type de résultat réel est identifié par l'espace de noms du résultat.

La valeur par défaut de cette propriété est Native.

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

ImpactAnalysis

Utilisation

Propriété Boolean facultative, en écriture seule

Description

Réservée pour un usage ultérieur.

La valeur par défaut de cette propriété est zéro (0).

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

LocaleIdentifier

Utilisation

Propriété Integer facultative, en lecture/écriture

Description

Lit ou définit l'identificateur de paramètres régionaux (LCID) utilisé par la méthode Discover ou Execute. Pour accéder à une liste hexadécimale complète des identificateurs de langue, recherchez « Language Identifiers » dans MSDN Library sur le Site Web Microsoft (en anglais).

Cette propriété ne possède pas de valeur par défaut.

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

MaximumRows

Utilisation

Propriété Integer facultative, en écriture seule

Description

Réservée pour un usage ultérieur.

Cette propriété ne possède pas de valeur par défaut.

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

MdpropAggregateCellUpdate

Utilisation

Propriété Integer facultative, en lecture seule

Description

Cette propriété est équivalente à la propriété OLE DB MDPROP_AGGREGATECELL_UPDATE.

La valeur par défaut de cette propriété est 4, ce qui équivaut à MDPROPVAL_AU_SUPPORTED.

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

MdpropAxes

Utilisation

Propriété Integer facultative, en lecture seule

Description

Cette propriété est équivalente à la propriété OLE DB MDPROP_AXES.

La valeur par défaut de cette propriété est 2147483647.

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

MdpropDrillFunctions

Utilisation

Propriété Integer facultative, en lecture seule

Description

Détermine le niveau de support pour les fonctions d'extraction sur le serveur. Les valeurs suivantes sont utilisées pour générer un masque de bits valide :

MDPROPVAL_MDF_BASIC (0x01)

MDPROPVAL_MDF_ASYMMETRIC (0x02)

MDPROPVAL_MDF_CALC_MEMBERS (0x04)

Les valeurs par défaut sont :

3 pour SQL Server 2008

7 pour SQL Server 2008 R2 et SQL Server 2012

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

MdpropFlatteningSupport

Utilisation

Propriété Integer facultative, en lecture seule

Description

Cette propriété est équivalente à la propriété OLE DB MDPROP_FLATTENING_SUPPORT.

La valeur par défaut de cette propriété est 1, ce qui équivaut à MDPROPVAL_FS_FULL_SUPPORT.

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

MdpropMdxCaseSupport

Utilisation

Propriété Integer facultative, en lecture seule

Description

Cette propriété est équivalente à la propriété OLE DB MDPROP_MDX_CASESUPPORT.

La valeur par défaut de cette propriété est zéro (0).

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

MdpropMdxDescFlags

Utilisation

Propriété Integer facultative, en lecture seule

Description

Cette propriété est équivalente à la propriété OLE DB MDPROP_MDX_DESCFLAGS.

La valeur par défaut de cette propriété est 7, ce qui équivaut à MDPROPVAL_MD_BEFORE, MDPROPVAL_MD_AFTER et MDPROPVAL_MD_SELF.

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

MdpropMdxFormulas

Utilisation

Propriété Integer facultative, en lecture seule

Description

Cette propriété est équivalente à la propriété OLE DB MDPROP_MDX_FORMULAS.

La valeur par défaut de cette propriété est 63, ce qui équivaut à une combinaison de MDPROPVAL_MF_WITH_CALCMEMBERS, MDPROPVAL_MF_WITH_NAMEDSETS, MDPROPVAL_MF_CREATE_CALCMEMBERS, MDPROPVAL_MF_CREATE_NAMEDSETS, MDPROPVAL_MF_SCOPE_SESSION et MDPROPVAL_MF_SCOPE_GLOBAL.

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

MdpropMdxJoinCubes

Utilisation

Propriété Integer facultative, en lecture seule

Description

Cette propriété est équivalente à la propriété OLE DB MDPROP_MDX_JOINCUBES.

La valeur par défaut de cette propriété est 1, ce qui équivaut à MDPROPVAL_MJC_SINGLECUBE.

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

MdpropMdxMemberFunctions

Utilisation

Propriété Integer facultative, en lecture seule

Description

Cette propriété est équivalente à la propriété OLE DB MDPROP_MDX_MEMBER_FUNCTIONS.

La valeur par défaut de cette propriété est 15, ce qui équivaut à une combinaison de toutes les valeurs OLE DB disponibles.

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

MdpropMdxNamedSets

Utilisation

Propriété Integer facultative, en lecture seule

Description

Masque de bits provenant de valeurs répertoriées dans la table suivante.

Valeur

Description

0x01

MDPROPVAL_MNS_BASIC.

0x02

MDPROPVAL_MNS_DYNAMIC.

0x04

MDPROPVAL_MNS_DISPLAYFOLDER.

0x08

MDPROPVAL_MNS_CAPTION.

Cette propriété a pour valeur par défaut 15.

MdpropMdxNonMeasureExpressions

Utilisation

Propriété Integer facultative, en lecture seule

Description

Cette propriété est équivalente à la propriété OLE DB MDPROP_MDX_NONMEASURE_EXPRESSIONS.

La valeur par défaut de cette propriété est zéro (0), ce qui équivaut à MDPROPVAL_NME_ALLDIMENSIONS.

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

MdpropMdxNumericFunctions

Utilisation

Propriété Integer facultative, en lecture seule

Description

Cette propriété est équivalente à la propriété OLE DB MDPROP_MDX_NUMERIC_FUNCTIONS.

La valeur par défaut de cette propriété est 2047, ce qui équivaut à une combinaison de MDPROPVAL_MNF_MEDIAN, MDPROPVAL_MNF_VAR, MDPROPVAL_MNF_STDDEV, MDPROPVAL_MNF_RANK, MDPROPVAL_MNF_AGGREGATE, MDPROPVAL_MNF_COVARIANCE, MDPROPVAL_MNF_CORRELATION, MDPROPVAL_MNF_LINREGSLOPE, MDPROPVAL_MNF_LINREGVARIANCE, MDPROPVAL_MNF_LINREG2 et MDPROPVAL_MNF_LINREGPOINT.

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

MdpropMdxObjQualification

Utilisation

Propriété Integer facultative, en lecture seule

Description

Cette propriété est équivalente à la propriété OLE DB MDPROP_MDX_OBJQUALIFICATION.

La valeur par défaut de cette propriété est 496, ce qui équivaut à une combinaison de MDPROPVAL_MOQ_DIM_HIER, MDPROPVAL_MOQ_DIMHIER_LEVEL, MDPROPVAL_MOQ_DIMHIER_MEMBER, MDPROPVAL_MOQ_LEVEL_MEMBER et MDPROPVAL_MOQ_MEMBER_MEMBER.

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

MdpropMdxOuterReference

Utilisation

Propriété Integer facultative, en lecture seule

Description

Cette propriété est équivalente à la propriété OLE DB MDPROP_MDX_OUTERREFERENCE.

La valeur par défaut de cette propriété est zéro (0).

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

MdpropMdxQueryByProperty

Utilisation

Propriété Boolean facultative, en lecture seule

Description

Cette propriété est équivalente à la propriété OLE DB MDPROP_MDX_QUERYBYPROPERTY.

La valeur par défaut de cette propriété est TRUE.

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

MdpropMdxRangeRowset

Utilisation

Propriété Integer facultative, en lecture seule

Description

Cette propriété est équivalente à la propriété OLE DB MDPROP_MDX_RANGEROWSET.

La valeur par défaut de cette propriété est 4, ce qui équivaut à MDPROPVAL_RR_UPDATE.

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

MdpropMdxSetFunctions

Utilisation

Propriété Integer facultative, en lecture seule

Description

Cette propriété est équivalente à la propriété OLE DB MDPROP_MDX_SET_FUNCTIONS.

La valeur par défaut de cette propriété est 524287, ce qui équivaut à une combinaison de MDPROPVAL_MSF_TOPPERCENT, MDPROPVAL_MSF_BOTTOMPERCENT, MDPROPVAL_MSF_TOPSUM, MDPROPVAL_MSF_BOTTOMSUM, MDPROPVAL_MSF_PERIODSTODATE, MDPROPVAL_MSF_LASTPERIODS, MDPROPVAL_MSF_YTD, MDPROPVAL_MSF_QTD, MDPROPVAL_MSF_MTD, MDPROPVAL_MSF_WTD, MDPROPVAL_MSF_DRILLDOWNMEMBER, MDPROPVAL_MSF_DRILLDOWNLEVEL, MDPROPVAL_MSF_DRILLDOWNMEMBERTOP, MDPROPVAL_MSF_DRILLDOWNMEMBERBOTTOM, MDPROPVAL_MSF_DRILLDOWNLEVEL, MDPROPVAL_MSF_DRILLDOWNLEVELTOP, MDPROPVAL_MSF_DRILLDOWNLEVELBOTTOM, MDPROPVAL_MSF_DRILLUPMEMBER, MDPROPVAL_MSF_DRILLUPLEVEL et MDPROPVAL_MSF_TOGGLEDRILLSTATE.

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

MdpropMdxSlicer

Utilisation

Propriété Integer facultative, en lecture seule

Description

Cette propriété est équivalente à la propriété OLE DB MDPROP_MDX_SLICER.

La valeur par défaut de cette propriété est 2, ce qui équivaut à MDPROPVAL_MS_SINGLETUPLE.

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

MdpropMdxStringCompop

Utilisation

Propriété Integer facultative, en lecture seule

Description

Cette propriété est équivalente à la propriété OLE DB MDPROP_MDX_STRING_COMPOP.

La valeur par défaut de cette propriété est 15, ce qui équivaut à une combinaison de MDPROPVAL_MSC_LESSTHAN, MDPROPVAL_MSC_GREATERTHAN, MDPROPVAL_MSC_LESSTHANEQUAL et MDPROPVAL_MSC_GREATERTHANEQUAL.

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

MdpropMdxSubQueries

Utilisation

Propriété Integer facultative, en lecture seule

Description

Indique le niveau de support pour les sous-requêtes dans MDX. Masque de bits provenant de valeurs répertoriées dans la table suivante.

Valeur

Description

0x01

MDPROPVAL_MSQ_BASIC.

0x02

MDPROPVAL_MSQ_ARBITRARYSHAPE.

0x04

MDPROPVAL_MSQ_NONVISUAL.

0x08

MDPROPVAL_MSQ_CALCMEMBERS.

0x10

MDPROPVAL_MSQ_CALCMEMBERS2

Cette propriété a pour valeur par défaut 31 dans SQL Server 2008 R2 et SQL Server 2012

Cette propriété a pour valeur par défaut 15 dans SQL Server 2008

Cette propriété a pour valeur par défaut 3 dans SQL Server 2005 Analysis Services.

MdpropNamedLevels

Utilisation

Propriété Integer facultative, en lecture seule

Description

Cette propriété est équivalente à la propriété OLE DB MDPROP_NAMED_LEVELS.

La valeur par défaut de cette propriété est 3, ce qui équivaut à une combinaison de MDPROPVAL_NL_NAMEDLEVELS et MDPROPVAL_NL_NUMBEREDLEVELS.

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

MdxMissingMemberMode

Utilisation

Propriété String facultative, en écriture seule

Description

Indique si les membres manquants sont ignorés dans les instructions MDX.

Cette propriété peut adopter l'une des valeurs répertoriées dans le tableau suivant.

Valeur

Description

Default

La valeur générée par l'instance Analysis Services est utilisée.

Error

Une erreur est générée.

Ignore

Les membres manquants sont toujours ignorés.

Cette propriété est équivalente à la propriété OLE DB DBPROP_MDX_MISSING_MEMBER_MODE.

La valeur par défaut de cette propriété est Default.

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

MDXSupport

Utilisation

Propriété String facultative, en lecture seule

Description

Spécifie une énumération qui décrit le degré de prise en charge MDX.

Cette propriété peut adopter l'une des valeurs répertoriées dans le tableau suivant.

Valeur

Description

Core

Toutes les options MDX sont prises en charge.

[!REMARQUE]

Actuellement, la seule valeur que l'énumération contient est Core. Dans les versions ultérieures, d'autres valeurs seront définies pour cette énumération.

La valeur par défaut de cette propriété est Core.

Cette propriété peut s'utiliser avec la méthode Discover.

NonEmptyThreshold

Utilisation

Propriété Integer facultative, en lecture/écriture

Description

Réservée pour un usage ultérieur.

Cette propriété ne possède pas de valeur par défaut.

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

Password

Utilisation

Propriété String facultative, en écriture seule

[!REMARQUE]

Cette propriété n'est plus prise en charge.

Description

Pour assurer la compatibilité descendante, cette propriété est ignorée et ne génère pas d'erreur lorsqu'elle est utilisée avec la méthode Execute ou Discover.

ProviderName

Utilisation

Propriété String facultative, en lecture seule

Description

Cette propriété est équivalente à la propriété OLE DB DBPROP_DBMSNAME.

La valeur par défaut de cette propriété est « OLAP Server ».

Cette propriété peut s'utiliser avec la méthode Discover.

ProviderType

Utilisation

Propriété Integer facultative, en lecture seule

Description

Cette propriété est équivalente à la propriété OLE DB DBPROP_DATASOURCE_TYPE.

La valeur par défaut de cette propriété est 6.

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

ProviderVersion

Utilisation

Propriété String facultative, en lecture seule

Description

Cette propriété est équivalente à la propriété OLE DB DBPROP_DBMSVER.

La valeur par défaut de cette propriété est la version de l'instance Analysis Services.

Cette propriété peut s'utiliser avec la méthode Discover.

ReadOnlySession

Utilisation

Propriété Integer facultative, en lecture/écriture

Description

Réservée pour un usage ultérieur.

Cette propriété ne possède pas de valeur par défaut.

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

RealTimeOlap

Utilisation

Propriété Boolean facultative, en lecture/écriture

Description

Lorsque cette propriété est spécifiée avec la valeur TRUE, toutes les partitions à l'écoute des notifications de table doivent être interrogées en temps réel, sans mise en cache préalable. Cette propriété est équivalente à la propriété OLE DB DBPROP_MSMD_REAL_TIME_OLAP.

La valeur par défaut de cette propriété est FALSE.

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

ReturnCellProperties

Utilisation

Propriété Boolean facultative, en lecture/écriture

Description

La valeur par défaut de cette propriété est FALSE.

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

Roles

Utilisation

Propriété String facultative, en lecture/écriture

Description

Spécifie une chaîne délimitée par des virgules contenant les noms de rôle sous lesquels une application cliente se connecte à une instance Analysis Services. Cette propriété permet à l'utilisateur de se connecter en employant un rôle différent de son rôle actuel. Par exemple, un administrateur de serveur peut souhaiter se connecter à un cube en tant que membre d'un rôle afin de tester les autorisations accordées à ce rôle. Cet utilisateur doit être un membre du rôle spécifié pour pouvoir se connecter à l'aide de cette propriété.

Important

Les noms de rôle respectent la casse, et les espaces ne doivent pas être utilisés entre les noms de rôle délimités par des virgules. Autrement, les requêtes portant sur des ensembles de cellules protégées risquent de retourner des erreurs et des résultats inattendus.

Cette propriété ne possède pas de valeur par défaut.

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

SafetyOptions

Utilisation

Propriété Integer facultative, en lecture/écriture

Description

Détermine si les bibliothèques potentiellement dangereuses peuvent être enregistrées et chargées par les applications clientes.

La valeur de cette propriété détermine également si le mot clé PASSTHROUGH est autorisé dans les cubes locaux. Une erreur se produit dans les cas de figure suivants :

  • Si une application cliente essaie de créer un cube local avec une instruction INSERT INTO qui contient le mot clé PASSTHROUGH.

  • Si une application cliente essaie de mettre à jour un cube local qui contient une instruction INSERT INTO utilisant le mot clé PASSTHROUGH.

Cette propriété peut adopter l'une des valeurs répertoriées dans le tableau suivant.

Nom

Valeur

Description

DBPROPVAL_MSMD_SAFETY_OPTIONS_DEFAULT

0

Cette valeur est traitée comme DBPROPVAL_MSMD_SAFETY_OPTIONS_ALLOW_SAFE.

Pour les connexions à un cube local, cette valeur dépend de l'utilisation de la propriété de chaîne de connexion CREATECUBE. Si la propriété de chaîne de connexion CREATECUBE est utilisée, cette valeur est équivalente à DBPROPVAL_MSMD_SAFETY_OPTIONS_ALLOW_ALL. Autrement, cette valeur est équivalente à DBPROPVAL_MSMD_SAFETY_OPTIONS_ALLOW_SAFE.

DBPROPVAL_MSMD_SAFETY_OPTIONS_ALLOW_ALL

1

Cette valeur active toutes les bibliothèques de fonctions définies par l'utilisateur sans vérifier qu'il est possible de les utiliser en toute sécurité pour l'initialisation et dans des scripts. Pour les connexions à des cubes locaux, cette valeur permet l'utilisation de procédures stockées et du mot clé PASSTHROUGH dans les instructions INSERT INTO.

Remarque relative à la sécuritéRemarque relative à la sécurité

Cette option n'est pas recommandée.

DBPROPVAL_MSMD_SAFETY_OPTIONS_ALLOW_SAFE

2

Cette valeur vérifie que toutes les classes pour une bibliothèque de fonctions définies par l'utilisateur particulière sont contrôlées de sorte qu'il est possible de les utiliser en toute sécurité pour l'initialisation et dans des scripts. Pour les connexions à des cubes locaux, cette valeur empêche l'utilisation du mot clé PASSTHROUGH dans les instructions INSERT INTO et celle des procédures stockées dont la propriété PermissionSet n'a pas la valeur Safe.

Cette valeur supprime également de l'ensemble de lignes de schéma MDSCHEMA_ACTIONS les actions ayant soit la valeur HTML ou COMMAND dans la colonne ACTION_TYPE, soit la valeur URL dans la colonne ACTION_TYPE et, dans la colonne CONTENT, une valeur qui ne commence pas par « http:// » ou « https:// ».

DBPROPVAL_MSMD_SAFETY_OPTIONS_ALLOW_NONE

3

Cette valeur empêche l'utilisation des fonctions définies par l'utilisateur pendant la session. Pour les connexions à des cubes locaux, cette valeur empêche l'utilisation de toutes les procédures stockées et du mot clé PASSTHROUGH dans les instructions INSERT INTO.

Cette valeur supprime également toutes les actions de l'ensemble de lignes de schéma MDSCHEMA_ACTIONS.

Cette propriété ne possède pas de valeur par défaut.

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

SecuredCellValue

Utilisation

Propriété Integer facultative, en lecture/écriture

Description

Spécifie le code d'erreur et les valeurs des propriétés de cellule Value et Formatted Value à retourner lors d'une tentative d'accès à une cellule protégée.

Cette propriété peut adopter l'une des valeurs répertoriées dans le tableau suivant.

Valeur

Description

0

(Valeur par défaut) Pour assurer la compatibilité avec les versions antérieures, cette valeur est équivalente à 1. La signification de cette valeur par défaut peut faire l'objet de modifications dans les futures versions.

1

Retourne : HRESULT = NO_ERROR

La propriété Value de la cellule contient le résultat sous la forme d'un type de données Variant. La chaîne « #N/A » est retournée dans la propriété Formatted Value.

2

Retourne une erreur comme valeur de HRESULT.

3

Retourne NULL dans les propriétés Value et Formatted Value.

4

Retourne un zéro numérique (0) dans la propriété Value et un zéro mis en forme dans la propriété Formatted Value. Par exemple, 0.00 est retourné dans la propriété Formatted Value pour une cellule dont la propriété Format est « #. ## ».

5

Retourne la chaîne « #SEC » dans les propriétés Value et Formatted Value.

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

ServerName

Utilisation

Propriété String facultative, en lecture seule

Description

Cette propriété est équivalente à la propriété OLE DB DBPROP_SERVERNAME.

La valeur par défaut de cette propriété est le nom de l'instance Analysis Services.

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

ShowHiddenCubes

Utilisation

Propriété Boolean facultative, en lecture/écriture

Description

Réservée pour un usage ultérieur.

La valeur par défaut de cette propriété est FALSE.

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

SQLQueryMode

Utilisation

Propriété String facultative, en lecture/écriture

Description

Détermine si les calculs sont inclus dans les requêtes SQL.

Cette propriété peut adopter l'une des valeurs répertoriées dans le tableau suivant.

Valeur

Description

Data

Aucun calcul n'est inclus.

Calculated

Les calculs sont retournés.

IncludeEmpty

Les calculs et les lignes vides sont retournés.

La valeur par défaut de cette propriété est Calculated.

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

SQLSupport

Utilisation

Propriété Integer facultative, en lecture seule

Description

La valeur par défaut de cette propriété est 512.

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

SspropInitAppName

Utilisation

Propriété String facultative, en lecture/écriture

Description

Contient le nom de l'application cliente.

Cette propriété ne possède pas de valeur par défaut.

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

SspropInitPacketsize

Utilisation

Propriété Integer facultative, en lecture/écriture

Description

Contient l'identificateur de l'application cliente.

Cette propriété ne possède pas de valeur par défaut.

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

SspropInitWsid

Utilisation

Propriété String facultative, en lecture/écriture

Description

Contient l'identificateur de la station de travail cliente.

Cette propriété ne possède pas de valeur par défaut.

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

StateSupport

Utilisation

Propriété String facultative, en lecture seule

Description

Spécifie le degré de prise en charge de la conservation de l'état.

Cette propriété peut adopter l'une des valeurs répertoriées dans le tableau suivant.

Valeur

Description

None

L'état n'est pas conservé.

Sessions

L'état est conservé grâce à la prise en charge de la session.

Pour plus d'informations sur la conservation de l'état et sa prise en charge à travers la session, consultez Gestion des connexions et des sessions (XMLA) (en anglais).

La valeur par défaut de cette propriété est Sessions.

Cette propriété peut s'utiliser avec la méthode Discover.

Timeout

Utilisation

Propriété Integer facultative, en lecture/écriture

Description

Spécifie le temps maximal, exprimé en secondes, pendant lequel l'instance Analysis Services doit attendre qu'une requête réussisse avant de retourner une erreur. De même que la propriété de chaîne de connexion Writeback Timeout, cette propriété détermine également le temps maximal pendant lequel l'instance doit attendre qu'une mise à jour d'une table d'écriture différée réussisse avant de retourner une erreur.

La valeur par défaut de cette propriété est zéro (0).

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

TransactionDDL

Utilisation

Propriété Integer facultative, en lecture seule

Description

Réservée pour un usage ultérieur.

La valeur par défaut de cette propriété est 0.

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

UserName

Utilisation

Propriété String facultative, en lecture seule

[!REMARQUE]

Cette propriété n'est plus prise en charge.

Description

Spécifie une chaîne qui retourne le nom d'utilisateur que l'instance Analysis Services associe à la commande. Pour assurer la compatibilité descendante, cette propriété est ignorée et ne génère pas d'erreur lorsqu'elle est utilisée avec la méthode Execute ou Discover. Cette propriété est équivalente à la propriété OLE DB DBPROP_USERNAME.

La valeur par défaut de cette propriété est le nom de l'utilisateur qui a ouvert la session ou la connexion active.

Cette propriété peut s'utiliser avec la méthode Execute.

VisualMode

Utilisation

Propriété Integer facultative, en écriture seule

Description

Cette propriété est équivalente à la propriété OLE DB MDPROP_VISUALMODE.

La valeur par défaut de cette propriété est zéro (0), ce qui équivaut à DBPROPVAL_VISUAL_MODE_DEFAULT.

Cette propriété peut s'utiliser avec les méthodes Discover et Execute.

Voir aussi

Référence

Élément PropertyList (XMLA)