MicroStrategy (API REST) 11.x - Import
Availability-note
AWS
Les fonctions exclusivement AWS sont disponibles via l'une des URL suivantes : us.cloud.talend.com, eu.cloud.talend.com, ap.cloud.talend.com
Prérequis du pont
Ce pont :nécessite une installation de l'outil pour accéder à son SDK.
Spécifications du pont
| Fournisseur | MicroStrategy |
| Nom de l'outil | Intelligence Server |
| Version de l'outil | 11.x |
| Site Web de l'outil | http://www.microstrategy.com/ |
| Méthodologie supportée | [Business Intelligence] Multimodèle, Conception BI (Source SGBDR, Source OLAP, Cible dimensionnelle, Lignage de transformation), Rapport BI (Source dimensionnelle, Structure de rapports) via une API REST |
| Profiling de données |  |
| Collecte incrémentale |  |
| Collecte multi-modèle | |
| Navigation dans le référentiel distant pour sélectionner un modèle | |
SPÉCIFICATIONS
Outil : MicroStrategy/Intelligence Server version 11.x via l'API REST
Consultez http://www.microstrategy.com/
Métadonnées : [Business Intelligence] Multimodèle, Conception BI (Source SGBDR, Source OLAP, Cible dimensionnelle, Lignage de transformation), Rapport BI (Source dimensionnelle, Structure de rapports)
Composant : MicroStrategyServer version 11.2.0
VUE D'ENSEMBLE
*** bridge_spec_microstrategyserver_import_description
Paramètres du pont
| Nom du paramètre | Description | Type | Valeurs | Défaut | Périmètre | ||
| Server URL | URL du serveur. http://localhost:8080/MicroStrategyLibrary | Chaîne de caractères | http://localhost:8080/MicroStrategyLibrary | Obligatoire ? | |||
| Projet(s) | Saisissez le(s) nom(s) du ou des projet(s) au(x)quel(s) vous souhaitez vous connecter dans la source de projet sélectionnée. | REPOSITORY_SUBSET | Tutoriel MicroStrategy | ||||
| Identifiant de connexion | Nom de l'utilisateur utilisé pour se connecter à la source de projet. Ce pont d'import est garanti pour être en lecture seule et n'affecte jamais le contenu du référentiel. Il est donc sûr d'effectuer la première collecte de métadonnées en tant qu'"Administrateur" afin de s'assurer que la totalité du contenu du référentiel est extrait sans problème d'autorisation d'accès. L'administrateur peut, éventuellement, configurer un utilisateur en "lecture seule". Pour plus d'informations, consultez la documentation concernant les autorisations et la sécurité. |
Chaîne de caractères | Administrator - Administrateur | Éléments obligatoires | |||
| Mot de passe de connexion | Mot de passe utilisé pour se connecter à la source de projet. | MOT DE PASSE | |||||
| Langue par défaut | Spécifiez la langue à utiliser. Par exemple en_us ou de |
Chaîne de caractères | |||||
| Niveau de conception de table du modèle de données | Contrôle la couche de conception des tables importées. Ce paramètre est utile lors de l'export de métadonnées vers un outil cible qui supporte deux vues du modèle : une vue logique et une vue physique. Certains outils de modélisation de données supportent le concept selon lequel vous pouvez décider si une table apparaît en tant que table physique et en tant qu'entité logique. Certains outils Business Intelligence supportent également ce concept selon lequel vous pouvez décider si une table apparaît à la fois dans un modèle physique et dans une vue métier du modèle. "Logical and physical (Logique et physique)" Les tables apparaissent à la fois dans la vue logique et dans la vue physique du modèle. "Physical (Physique)" Les tables apparaissent uniquement dans la vue physique du modèle. |
ÉNUMÉRATION |
|
Physique | |||
| Importer des jointures | Les jointures doivent-elles être importées ? "True (Vrai)" Les jointures sont importées. "False (Faux)" Les jointures ne sont pas importées. |
BOOLEAN |
|
true | |||
| Importer les hiérarchies | Les hiérarchies doivent-elles être importées ? "True (Vrai)" Les hiérarchies sont importées. "False (Faux)" Les hiérarchies ne sont pas importées. |
BOOLEAN |
|
true | |||
| Threads multiples | Nombre de threads workers pour la collecte asynchrone des métadonnées. - Laissez ce paramètre vide si vous souhaitez que le pont d'import calcule la valeur, entre 1 et 6, en se basant sur l'architecture de la JVM et le nombre de cœurs du processeur disponibles. - Spécifiez une valeur numérique supérieure ou égale à 1 pour indiquer le nombre réel de threads. Si la valeur spécifiée n'est pas valide, un avertissement sera émis et cette valeur sera remplacée par 1. Si vous manquez de mémoire lors de la collecte asynchrone, réessayez avec un nombre plus petit. Si votre machine dispose de beaucoup de mémoire (par exemple 10 Go ou plus), vous pouvez essayer avec un plus grand nombre pour la collecte simultanée de nombreux documents. Notez que la définition d'un nombre trop important peut engendrer une diminution des performances en raison d'un conflit des ressources. |
NUMERIC | |||||
| Miscellaneous | INTRODUCTION Spécifiez les options Divers, commençant par un tiret et suivies éventuellement par des paramètres, par exemple : -connection.cast MyDatabase1="MICROSOFT SQL SERVER" Certaines options peuvent être utilisées plusieurs fois, si applicable, par exemple : -connection.rename NewConnection1=OldConnection1 -connection.rename NewConnection2=OldConnection2; La liste d'options pouvant être une longue chaîne, il est possible de la charger à partir d'un fichier qui doit être situé dans ${MODEL_BRIDGE_HOME}\data\MIMB\parameters et avoir l'extension .txt. Dans ce cas, toutes les options doivent être définies au sein de ce fichier comme seule valeur de ce paramètre, par exemple ETL/Miscellaneous.txt OPTIONS DE L'ENVIRONNEMENT JAVA -java.memory <taille maximale de la mémoire Java> (anciennement -m) 1 Go par défaut sur un JRE de 64 bits ou tel que défini dans conf/conf.properties, par exemple -java.memory 8G -java.memory 8000M -java.parameters <options de ligne de commande de Java Runtime Environment> (anciennement -j) Cette option doit être la dernière dans le paramètre Divers car tout le texte après -java.parameters est passé tel quel à la JRE. Par ex. -java.parameters -Dname=value -Xms1G L'option suivante doit être définie lorsqu'un proxy est utilisé pour accéder à Internet (cela est essentiel pour accéder à https://repo.maven.apache.org/maven2/ et exceptionnellement à quelques autres sites d'outils) afin de télécharger les bibliothèques logicielles tierces nécessaires. Note : La majorité des proxys sont relatifs au chiffrement (HTTPS) du trafic extérieur (à l'entreprise) et à la confiance en le trafic intérieur pouvant accéder au proxy via HTTP. Dans ce cas, une requête HTTPS atteint le proxy via HTTP où le proxy la chiffre en HTTPS. -java.parameters -java.parameters -Dhttp.proxyHost=127.0.0.1 -Dhttp.proxyPort=3128 -Dhttp.proxyUser=user -Dhttp.proxyPassword=pass OPTIONS D'IMPORT DU MODÈLE -model.name <nom modèle> Écrase le nom du modèle, par ex. -model.name "My Model Name" -prescript <nom script> Cette option permet d'exécuter un script avant l'exécution du pont. Le script doit se situer dans le répertoire bin (ou comme spécifié dans M_SCRIPT_PATH dans conf/conf.properties) et avoir une extension .bat ou .sh. Le chemin d'accès au script ne doit pas inclure de symbole relatif au répertoire parent (..). Le script doit retourner le code de sortie 0 pour indiquer un succès ou une autre valeur pour indiquer un échec. Par exemple : -prescript "script.bat arg1 arg2" -postscript <nom script> Cette option permet d'exécuter un script après l'exécution réussie du pont. Le script doit se situer dans le répertoire bin (ou comme spécifié dans M_SCRIPT_PATH dans conf/conf.properties) et avoir une extension .bat ou .sh. Le chemin d'accès au script ne doit pas inclure de symbole relatif au répertoire parent (..). Le script doit retourner le code de sortie 0 pour indiquer un succès ou une autre valeur pour indiquer un échec. Par exemple : -postscript "script.bat arg1 arg2" -cache.clear Vide le cache avant l'import et va exécuter un import complet avec collecte incrémentale. Si le modèle n'a pas été modifié et que le paramètre -cache.clear n'est pas utilisé (collecte incrémentale), une nouvelle version ne sera pas créée. Si le modèle n'a pas été modifié et que le paramètre -cache.clear n'est pas utilisé (collecte incrémentale), une nouvelle version ne sera pas créée. -backup <répertoire> Permet d'enregistrer les métadonnées d'entrée à des fins de débogage. Le <répertoire> fourni doit être vide. -restore <répertoire> Spécifiez le <répertoire> de sauvegarde à restaurer. OPTIONS DES CONNEXIONS DE DONNÉES Les connexions de données sont produites par les ponts d'import, généralement à partir des outils ETL/DI et BI pour faire référence aux data stores sources et cibles qu'elles utilisent. Ces connexions de données sont ensuite utilisées par les outils de gestion des métadonnées pour connecter ces dernières (connexion des métadonnées) à leurs data stores réels (par exemple, bases de données, système de fichiers, etc.) afin de produire le lignage complet de flux de données et de l'analyse d'impact de bout en bout. Le nom des connexions de données doit être unique dans chaque modèle d'import. Les noms de connexion de données utilisés dans les outils de conception DI/BI sont utilisés quand cela est possible, sinon ils sont générés en étant courts mais significatifs, comme le nom de la base de données/du schéma, le chemin d'accès au système de fichiers ou l'URI (Uniform Resource Identifier). L'option suivante vous permet de manipuler les connexions. Ces options remplacent les options héritées -c, -cd et -cs. -connection.cast ConnectionName=ConnectionType Lance une connexion à une base de données générique (par exemple ODBC/JDBC) pour un type de base de données précis (par exemple ORACLE) pour une analyse SQL, par exemple -connection.cast "My Database"="MICROSOFT SQL SERVER". La liste des types de connexions aux data stores comprend : ACCESS APACHE CASSANDRA DB2/UDB DENODO GOOGLE BIGQUERY HIVE MYSQL NETEZZA ORACLE POSTGRESQL PRESTO REDSHIFT SALESFORCE SAP HANA SNOWFLAKE MICROSOFT SQL AZURE MICROSOFT SQL SERVER SYBASE SQL SERVER SYBASE AS ENTERPRISE TERADATA VECTORWISE HP VERTICA -connection.rename OldConnection=NewConnection Renomme une connexion existante, par exemple, par ex. -connection.rename OldConnectionName=NewConnectionName Plusieurs connexions de bases de données existantes peuvent être renommées et fusionnées en une nouvelle connexion de base de données, par exemple : -connection.rename MySchema1=MyDatabase -connection.rename MySchema2=MyDatabase -connection.split oldConnection.Schema1=newConnection Scinde une connexion de base de données en une ou plusieurs connexions de base de données. Une connexion de base de données peut être scindée en une connexion par schéma, par exemple : -connection.split MyDatabase Toutes les connexions de base de données peuvent être fractionnées en une connexion par schéma, par exemple : -connection.split * Une connexion de base de données peut être explicitement fractionnée en une nouvelle connexion de base de données en ajoutant un nom de schéma à une base de données, par exemple : -connection.split MyDatabase.schema1=MySchema1 -connection.map SourcePath=DestinationPath Mappe un chemin d'accès source à un chemin d'accès de destination. Cela est utile pour les connexions aux systèmes de fichiers lorsque différents chemins d'accès pointent vers le même objet (répertoire ou fichier). Sur Hadoop, un processus peut écrire dans un fichier CSV spécifié avec le chemin d'accès complet HDFS, tandis qu'un autre processus lit d'une table Hive implémentée (externe) par le même fichier spécifié à l'aide d'un chemin d'accès relatif avec un nom et une extension de fichier par défaut, par exemple : -connection.map /user1/folder=hdfs://host:8020/users/user1/folder/file.csv Sous Linux, il peut être fait référence à un répertoire (ou à un fichier) donné tel que /data par plusieurs liens symboliques tels que /users/john et /users/paul, par exemple : -connection.map /data=/users/John -connection.map /data=/users/paul Sous Windows, il peut être fait référence à un répertoire donné tel que C:\data par plusieurs lecteurs réseau tels que M: et N:, par exemple : -connection.map C:\data=M:\ -connection.map C:\data=N:\ -connection.casesensitive ConnectionName... Écrase les règles de rapprochement insensibles à la casse par défaut pour les identifiants d'objets dans la connexion spécifiée, si le type du data store détecté supporte cette configuration (par ex. Microsoft SQL Server, MySQL etc.), par exemple : -connection.casesensitive "My Database" -connection.caseinsensitive ConnectionName... Écrase les règles de rapprochement sensibles à la casse par défaut pour les identifiants d'objets dans la connexion spécifiée, si le type du data store détecté supporte cette configuration (par ex. Microsoft SQL Server, MySQL etc.), par exemple : -connection.caseinsensitive "My Database" -connection.level AggregationLevel Spécifie le niveau d'agrégation pour les connexions externes, par exemple -connection.level catalog Liste des valeurs supportées : server (serveur) catalog (catalogue) schema (schéma)(par défaut) OPTIONS MICROSTRATEGY -sf Ignorez l'import des filtres. SP Ignorer l'import des invites. -folders.exclude <chemin d'accès au fichier> L'option folders.exclude vous permet d'exclure des dossiers au sein d'un projet. Vous devez spécifier le chemin d'accès au fichier contenant la liste des chemins d'accès aux dossiers MicroStrategy. -folders.exclude E:\Microstrategy\folders.txt Par exemple, le fichier folders.txt comprend deux chemins d'accès aux dossiers \MicroStrategy Tutorial\Object Templates \MicroStrategy Tutorial\Profiles -folders.include <chemin d'accès> L'option folders.include vous permet d'importer uniquement des dossiers spécifiques au sein d'un projet. Vous devez spécifier le chemin d'accès au fichier contenant la liste des chemins d'accès aux dossiers MicroStrategy. -folders.include E:\Microstrategy\folders.txt Par exemple, le fichier folders.txt comprend deux chemins d'accès aux dossiers \MicroStrategy Tutorial\Object Templates \MicroStrategy Tutorial\Profiles |
Chaîne de caractères |
Mapping du pont
| Meta Integration Repository (MIR) Métamodèle (se base sur le standard OMG CWM) |
"MicroStrategy (API REST) 11.x - Nouveau pont Bêta" Métamodèle MicroStrategy |
Mapping des commentaires |
| Argument | Paramètre de la fonction | |
| Commentaire | Commentaires | |
| Description | Description | |
| Name (Nom) | Name (Nom) | |
| NativeId | ID | ID de l'objet MicroStrategy |
| Association | Les clés et les contraintes d'intégrité ne persistent pas dans les métadonnées | |
| AssociationRole | Les clés et les contraintes d'intégrité ne persistent pas dans les métadonnées | |
| AssociationRoleNameMap | Les clés et les contraintes d'intégrité ne persistent pas dans les métadonnées | |
| Attribut | Colonne de table de warehouse | |
| Commentaire | Commentaires | |
| Description | Description | |
| DesignLevel | comme défini par l'option "Table Logical information (Informations logiques de la table)" du pont | |
| Name (Nom) | Name (Nom) | |
| NativeId | ID | ID de l'objet MicroStrategy |
| Position | comme retourné par l'API | |
| BaseType | Datatype | |
| DataType (TypeDeDonnées) | Voir le tableau de conversion des types de données | |
| Name (Nom) | Dérivé du type de données | |
| NativeId | ID | ID de l'objet MicroStrategy |
| PhysicalName | Dérivé du type de données | |
| CandidateKey | Les clés et les contraintes d'intégrité référentielles ne persistent pas dans les métadonnées | |
| Classe | Table de warehouse | |
| Commentaire | Commentaires | |
| CppClassType | Configuré comme ENTITÉ | |
| CppPersistent | Configuré à Vrai | |
| Description | Description | |
| DesignLevel | comme défini par l'option "Table Logical information (Informations logiques de la table)" du pont | |
| Name (Nom) | Name (Nom) | |
| NativeId | ID | ID de l'objet MicroStrategy |
| ClassifierMap | Utilisé pour conserver les métadonnées du lignage | |
| NativeId | ID | ID de l'objet MicroStrategy |
| Condition | Lookup LogicalTable, Filtre | Indique la manière dont est effectuée la jointure entre les LogicalTables. Des conditions sont également créées lors de l'import de filtres |
| DatabaseSchema | Table de warehouse | |
| Name (Nom) | Namespace | |
| NativeId | ID | ID de l'objet MicroStrategy |
| DerivedType | Datatype | |
| DataType (TypeDeDonnées) | DataType (TypeDeDonnées) | Voir le tableau de conversion des types de données |
| Longueur | Longueur en octets | |
| Name (Nom) | Dérivé du type de données | |
| NativeId | ID | ID de l'objet MicroStrategy |
| PhysicalName | Dérivé du type de données | |
| Échelle | Échelle | |
| DesignPackage | Folder | Les objets importés de MicroStrategy sont placés dans leurs dossiers respectifs |
| Commentaire | Commentaires | |
| Description | Description | |
| Name (Nom) | Name (Nom) | |
| NativeId | ID | ID de l'objet MicroStrategy |
| UserDefined | Configuré à TRUE (Vrai) | |
| Dimension | LogicalTable, Attribut, Fait, Métrique | Chaque LogicalTable est importée en tant que dimension. Des dimensions sont également créées pour jouer le rôle de classifieur pour les attributs, les faits et les métriques |
| Commentaire | Commentaires | |
| Description | Description | |
| Name (Nom) | Name (Nom) | |
| NativeId | ID | ID de l'objet MicroStrategy |
| Type | configuré à FACT (FAIT) si la table logique contient des faits, sinon configuré à REGULAR (NORMAL) | |
| UserDefined | Configuré à TRUE (Vrai) | |
| DimensionAttribute | LogicalTable BaseAttributeForm | Chaque BaseAttributeForm (implémentation d'un AttributeForm dans le contexte d'une LogicalTable) est importé comme DimensionAttribute |
| Commentaire | Commentaires | |
| Description | AttributeFormDescription | |
| Name (Nom) | "AttributeName (AttributeFormName)" | |
| NativeId | ID | ID de l'objet MicroStrategy |
| Position | comme retourné par l'API | |
| DrillPath | Hiérarchie | Les hiérarchies sont importées comme MIRDrillPath car elles peuvent avoir plusieurs niveaux supérieurs (points d'entrée) et peuvent s'étendre sur plusieurs niveaux à travers différentes MIRDimensions |
| Commentaire | Commentaires | |
| Description | Description | |
| Name (Nom) | Name (Nom) | |
| NativeId | ID | ID de l'objet MicroStrategy |
| DrillPathLevelAssociation | Hiérarchie | Utilisée pour connecter les Niveaux utilisés dans une hiérarchie |
| NativeId | ID | ID de l'objet MicroStrategy |
| Position | non pertinent pour les hiérarchies déséquilibrées | |
| FeatureMap | AttributeForm, Fait | Utilisé pour conserver les métadonnées du lignage et des expressions |
| NativeId | ID | ID de l'objet MicroStrategy |
| Operation (Opération) | Texte d'expression | vide s'il y a un mapping direct vers une fonctionnalité source |
| Filter | Filtre, CustomGroup, Filtre de sécurité | |
| Commentaire | Commentaires | |
| Description | Description | |
| Name (Nom) | Name (Nom) | |
| NativeId | ID | ID de l'objet MicroStrategy |
| ForeignKey | Les clés et les contraintes d'intégrité référentielles ne persistent pas dans les métadonnées | |
| Jointure | Lookup LogicalTable | Les jointures sont importées en fonction de LogicalTable de lookup de chaque AttributeForm |
| JoinRole | Lookup LogicalTable | Connecte deux tables logiques (LogicalTables) d'une jointure |
| Niveau | Attribut | Les attributs sont importés en tant que Levels (Niveaux) |
| Commentaire | Commentaires | |
| Description | Description | |
| Name (Nom) | Name (Nom) | |
| NativeId | ID | ID de l'objet MicroStrategy |
| LevelAssociation | AttributeRelationship | Spécifie les relations parent-enfant entre les niveaux, utilisés dans des DrillPaths via des objets DrillPathLevelAssociation |
| LevelAttribute | AttributeForm | |
| Commentaire | Commentaires | |
| Description | Description | |
| Name (Nom) | Name (Nom) | |
| NativeId | ID | ID de l'objet MicroStrategy |
| Mesurer | LogicalTable FactInfo, Fait, Métrique | Chaque fait est importé comme Measure (Mesure) Chaque FactInfo (implémentation d'un fait dans le contexte d'une table logique) est importé comme Measure (Mesure) Chaque métrique est importée comme Measure (Mesure) |
| Commentaire | Commentaires | |
| Description | Description | |
| Name (Nom) | Name (Nom) | |
| NativeId | ID | ID de l'objet MicroStrategy |
| Position | Position de FactInfo dans la table LogicalTable, comme retourné par l'API | |
| Operation (Opération) | Fonction | Chaque fonction est importée comme Operation (Opération) |
| Commentaire | Commentaires | |
| Description | Description | |
| Name (Nom) | Name (Nom) | |
| NativeId | ID | ID de l'objet MicroStrategy |
| Invite | Invite | |
| Name (Nom) | Name (Nom) | |
| Question | Afficher la description/la signification | |
| PromptAnswer | Invite | |
| Commentaire | Commentaires | |
| Description | Description | |
| Name (Nom) | Name (Nom) | |
| NativeId | ID | |
| Rapport | Rapport, Document | |
| Commentaire | Commentaires | |
| Description | Description | |
| Name (Nom) | Name (Nom) | |
| ReportAttribute | Attribut, Métrique, Limite, Consolidation, Sous-total | Représente les objets utilisés dans le rapport |
| Name (Nom) | Name (Nom) | |
| ReportAxis | Axe de rapport | Représente l'axe vertical, horizontal et de page du rapport |
| ReportChart | Rapport de graphique | |
| ReportDataSet | Attribut, Métrique, Limite, Consolidation, Sous-total | Représente les objets utilisés dans le rapport et la manière dont ils sont groupés |
| Name (Nom) | Name (Nom) | |
| ReportField | Élément du modèle de rapport | |
| ReportPage | Rapport | |
| ReportPageBody | Corps du document | |
| ReportPageFooter | Pied de page du document | |
| ReportPageHeader | En-tête du document | |
| ReportTable | Rapport de grille | |
| ReportText | Champ de texte | |
| Value (Valeur) | valeur textuelle | |
| StoreConnection | Catalogue du warehouse | |
| NativeId | ID | ID de l'objet MicroStrategy |
| StoreModel | Projet | L'accès au projet se fait via le nom d'une source de données (Data Source Name) pointant vers MicroStrategy Intelligence Server |
| Commentaire | Commentaires | |
| Description | Description | |
| Name (Nom) | Name (Nom) | |
| NativeId | ID | ID de l'objet MicroStrategy |
| SystemType | Type | |
| SystemTypeOld | Type |