exportQueryResults

Champ d'application

Rôles requis

Syntaxe

• APPLICATION_NAME est le nom de l'application Profitability and Cost Management pour laquelle exécuter la requête.
• fileName est le nom du fichier qui stockera les résultats de requête. La valeur de ce paramètre est requise si la valeur du paramètre queryName n'est pas indiquée. Elle est facultative si la valeur du paramètre queryName est indiquée, auquel cas le nom de requête est utilisé comme nom du fichier de résultats de requête.

  Le format de données indiqué détermine le format du fichier de sortie. Si vous utilisez dataFormat=NATIVE (valeur par défaut), le processus d'export crée un fichier texte. Si vous utilisez dataFormat=COLUMNAR, le processus d'export crée plusieurs fichiers texte numérotés de façon séquentielle et les compresse ensuite dans un fichier ZIP.

• fileOutputOptions (facultatif) indique le format de sortie du fichier de résultats de requête. La valeur par défaut est ZIP_ONLY, qui crée fileName.ZIP ou queryName.ZIP selon qu'une valeur est indiquée ou non pour le paramètre fileName. Les autres options sont TEXT_ONLY, pour créer le fichier de sortie sous forme de fichier texte, et ZIP_AND_TEXT, pour générer un fichier texte et un fichier ZIP.
• queryName est un paramètre facultatif qui identifie une requête définie dans l'application. Les noms de requête qui contiennent un espace doivent être placés entre guillemets doubles.

  N'indiquez pas de nom de requête si vous voulez exporter toutes les données Oracle Essbase appartenant à l'application.

  Les conditions suivantes peuvent entraîner la création d'un fichier de données vide par cette commande :

  • une requête dont le format est incorrect qui n'extrait aucune donnée ;
  • une requête qui génère trop de données. Dans ce scénario, envisagez de réduire la portée de la requête de sorte qu'elle extraie moins de données ou divisez la requête en de plus petites requêtes.

    Reportez-vous à la section Gestion des requêtes Oracle Profitability and Cost Management Cloud du guide Administration de Profitability and Cost Management.

• exportOnlyLevel0Flg (facultatif) indique si la requête ne doit extraire que les données de niveau 0. Indiquez cette valeur de paramètre entièrement en minuscules.

  Ce paramètre est ignoré si vous exportez toutes les données d'application en omettant le nom de la requête.

• roundingPrecision (facultatif) indique le nombre de décimales (précision à l'arrondi) à utiliser lors de l'export des résultats de requête. Applicable uniquement lorsque queryName est indiqué. La valeur par défaut est 2.
• dataFormat (facultatif) indique le format de sortie. Les valeurs valides sont les suivantes :
  • NATIVE, qui conserve le résultat de la requête sous forme de données au format natif Essbase. Il s'agit de la valeur par défaut.
  • COLUMNAR, qui convertit les données utilisant le format natif Essbase et les classe en colonnes pour en faciliter l'interprétation et l'import dans d'autres applications.

    Cette option exporte toutes les données Essbase et ignore la valeur du paramètre queryName. Pour filtrer les données, définissez la valeur du paramètre memberFilters.

  Remarque :

  La commande ne tient compte des paramètres facultatifs suivants que si dataFormat indique COLUMNAR.
• memberFilters (facultatif) accepte une chaîne au format JSON pour filtrer par dimension et par membre de niveau 0. Exemple : "{\"Dim1\":[\"Mem1\"],\"Dim2\":[\"Mem21\",\"Mem22\"]}"
• includeHeader (facultatif) ajoute des noms de dimension en tant qu'en-têtes de colonne. Définissez cette valeur sur false pour exclure l'en-tête de colonne. La valeur par défaut est true.
• delimiter (facultatif) identifie le séparateur à utiliser pour séparer les membres de dimension dans le fichier de résultats de requête. Le séparateur doit être placé entre guillemets doubles. La valeur par défaut est un espace (" ").
• keepDuplicateMemberFormat (facultatif) indique si le format de membre doit être imprimé au format de membre dupliqué Essbase, par exemple, [Account]@[Accoun1]. Définissez cette valeur sur false pour n'imprimer que le nom du membre. La valeur par défaut est true.

Exemples

• Export de toutes les données d'application :

  epmautomate exportQueryResults BksML12 fileName="BksML12_MyQuery1.txt" fileOutputOptions=TEXT_ONLY

• Export des résultats d'une requête spécifique :

  epmautomate exportQueryResults BksML12 queryName="My Product Query" roundingPrecision=3

• Export des données de niveau 0 au format NATIVE :

  epmautomate exportQueryResults BksML30 fileName="BksML30_ExportLevel0-Data" fileOutputOptions=ZIP_AND_TEXT exportOnlyLevel0Flg=true

• Export des données de niveau 0 au format COLUMNAR avec une seule dimension et un seul filtre de membre :

  epmautomate exportQueryResults BksML30 fileName="BksML30_Level0-Data" dataFormat="COLUMNAR" memberFilters="{\"Period\":[\"December\"]}" includeHeader="true" delimiter="," roundingPrecision="3"

• Export des données de niveau 0 au format COLUMNAR avec une seule dimension et plusieurs filtres de membre :

  epmautomate exportQueryResults BksML30 fileName="BksML30_Level0-Data" dataFormat="COLUMNAR" memberFilters="{\"Period\":[\"November\",\"December\"]}" includeHeader="true" delimiter="," roundingPrecision="3"

• Export des données de niveau 0 au format COLUMNAR avec plusieurs dimensions et plusieurs filtres de membre :

  epmautomate exportQueryResults BksML30 fileName="BksML30_Level0-Data" dataFormat="COLUMNAR" memberFilters="{\"Year\":[\"2016\"],\"Period\":[\"November\",\"December\"]}" includeHeader="true" delimiter="," roundingPrecision="3"