Instruction CREATE ACTION (MDX)
Mis à jour : 17 juillet 2006
Crée une action qui peut être associée à un cube, une dimension, une hiérarchie ou un objet subordonné.
Syntaxe
CREATE ACTION CURRENTCUBE | Cube_Name
.Action_Name <action body>
<action body> ::=
FOR
CUBE
| Hierarchy_Name [MEMBERS]
| Level_Name [MEMBERS]
| CELLS
| SET }
AS 'MDX_Expression'
[, TYPE = '
{ URL
| HTML
| STATEMENT
| DATASET
| ROWSET
| COMMANDLINE
| PROPRIETARY }
']
[ , INVOCATION = 'INTERACTIVE | ON_OPEN | BATCH ' ]
[ , APPLICATION = String_Expression ]
[ , DESCRIPTION = String_Expression ]
[ , CAPTION = 'MDX_Expression' ]
Arguments
- Cube_Name
Chaîne valide qui précise le nom d'un cube.
- Action_ Name
Chaîne valide qui fournit le nom d'une action en cours de création.
- Hierarchy_ Name
Chaîne valide qui précise le nom d'une hiérarchie.
- Level_ Name
Chaîne valide qui précise le nom d'un niveau.
- Member_ Name
Chaîne valide qui précise un nom de membre ou une clé de membre.
- MDX_Expression
Expression MDX valide.
- String_Expression
Expression de chaîne valide.
Notes
Les applications clientes peuvent créer et exécuter des actions qui ne sont pas sûres ; elles peuvent également utiliser des fonctions peu sûres. Pour éviter ces situations, utilisez la propriété Safety Options. Pour plus d'informations, consultez la propriété Safety Options.
Remarque : |
---|
Cette instruction est comprise pour des raisons de compatibilité descendante. Les actions nouvelles dans SQL Server 2005 Analysis Services (SSAS), telles que les actions d'extraction ou de rapport, ne sont pas prises en charge. |
Types d'actions
Le tableau ci-dessous décrit les différents types d'actions disponibles dans Microsoft SQL Server 2005 Analysis Services (SSAS).
Type d'action
Description
URL
La chaîne d'action retournée est une URL qui doit être ouverte dans un navigateur Internet.
Remarque :
Si cette action ne commence pas par http://
ou https://
, l'action ne sera pas disponible dans le navigateur à moins que SafetyOptions ne soit défini sur DBPROPVAL_MSMD_SAFETY_OPTIONS_ALLOW_ALL.
HTML
La chaîne d'action retournée est un script HTML. Cette chaîne doit être enregistrée dans un fichier, qui devra être rendu à l'aide d'un navigateur Internet. Dans ce cas, un script entier peut être exécuté en tant que partie du fichier HTML généré.
STATEMENT
La chaîne d'action retournée est une instruction qui doit être exécutée en définissant la méthode ICommand::SetText d'un objet commande sur cette chaîne et en appelant la méthode ICommand::Execute . Si la commande échoue, un message d'erreur est retourné.
DATASET
La chaîne d'action retournée est une instruction MDX qui doit être exécutée en définissant la méthode ICommand::SetText d'un objet de commande sur cette chaîne et en appelant la méthode ICommand::Execute. L'ID d'interface (IID) requise doit être IDataset. Cette commande réussit si un dataset a été créé. L'application cliente doit autoriser l'utilisateur à parcourir le dataset retourné.
ROWSET
Semblable à DATASET, mais au lieu de demander un IID de IDataset, l'application cliente demande un IID de IRowset. Cette commande réussit si un ensemble de lignes a été créé. L'application cliente doit autoriser l'utilisateur à parcourir l'ensemble de lignes retourné.
COMMANDLINE
L'application cliente doit exécuter la chaîne d'action. Cette chaîne est une ligne de commande.
PROPRIETARY
Une application cliente ne doit pas afficher ni exécuter l'action, à moins d'avoir une connaissance personnalisée, non générique, de cette action spécifique. Les actions propriétaires ne sont pas retournées à l'application cliente, à moins que celle-ci ne les demande explicitement en définissant la restriction appropriée sur APPLICATION_NAME.
Types d'invocations
Le tableau ci-dessous décrit les différents types d'invocations disponibles dans Analysis Services. Le type d'invocation n'est utilisé que par l'application cliente pour déterminer à quel moment appeler l'action. Il ne détermine pas réellement le comportement d'invocation de l'action.
Type d'invocation | Description |
---|---|
INTERACTIVE |
Cette action doit être appelée par l'application cliente via l'interaction de l'utilisateur. |
ON_OPEN |
Cette action doit être appelée par l'application cliente lors de l'ouverture de l'objet cible. Ce type d'invocation n'est actuellement pas implémenté. |
BATCH |
Cette action doit être appelée par l'application cliente lorsque l'objet cible est impliqué dans une opération par lots, comme déterminé par l'application cliente. Ce type d'invocation n'est actuellement pas implémenté. |
Étendue
Chaque action est définie pour un cube spécifique et possède un nom unique dans ce cube. Une action peut avoir l'une des étendues répertoriées dans le tableau ci-après.
- Étendue de cube
Pour les actions indépendantes de dimensions, membres ou cellules spécifiques ; par exemple : « Lancer l'émulation de terminaux pour un système de production AS/400 ».
- Étendue de dimension
Cette action s'applique à une dimension spécifique. Elle ne dépend pas d'une sélection spécifique de niveaux ou de membres.
- Étendue de niveau
Cette action s'applique à un niveau de dimension spécifique. Elle ne dépend pas de la sélection spécifique d'un membre dans cette dimension.
- Étendue de membre
Cette action s'applique aux membres d'un niveau spécifique.
- Étendue de cellule
Cette action s'applique uniquement à des cellules spécifiques.
- Étendue de jeu
Cette action s'applique uniquement à un jeu. Le nom, ActionParameterSet, n'est utilisé que par l'application à l'intérieur de l'expression de l'action.
Voir aussi
Autres ressources
Instructions MDX de définition de données (MDX)
Aide et Informations
Assistance sur SQL Server 2005
Historique des modifications
Version | Historique |
---|---|
17 juillet 2006 |
|