Partager cette page

# Utilisation de DQL

Langage de requêtes de domaine qu’utilise le processus de création de requêtes de vue d’entreprise.

DQL correspond pour l’essentiel à ANSI SQL 9.2, avec toutefois quelques différences importantes.

Note : DQL ne prend en charge que les instructions SELECT.

Dans cette rubrique :

## Avantages de DQL

L’élaboration de requêtes avec DQL présente les avantages ci-après.

DQL applique le masquage des données en fonction des niveaux de permission de l’utilisateur. | Les rapports sont générés en fonction des niveaux d’autorisation de l’utilisateur qui les génère. Les informations incluses dans une vue métier qui n’est pas disponible pour un utilisateur n’apparaissent dans aucun rapport créé par l’utilisateur.
La requête DQL crée une abstraction de base de données utilisée comme base pour la vue métier. | Étant donné que la base de la vue est une abstraction de la base de données et non la base de données elle-même, vous n’avez pas besoin d’identifier les champs d’entité selon leurs noms réels. Par exemple, tous les champs relatifs à l’identification d’un objet apparaissent avec le suffixe « ID », tels que Defect ID, Cycle ID et Release ID.
Les requêtes DQL fonctionnent sur les serveurs de bases de données Oracle et SQL. |

Retour en haut

## Ajouts à SQL

DQL fournit les options suivantes, qui ne sont pas disponibles en SQL ANSI :

- Variables. Trois variables ont été ajoutées.

  :me | Renvoie les informations pertinentes pour l’utilisateur qui crée le rapport. Cela signifie que différents utilisateurs qui créent des rapports basés sur la même vue d’entreprise recevront des résultats différents. La variable :me ressemble à ceci : Copy code
      Select *
      From defect
      Where defect.detected_by = :me
  :current_project_name | Renvoie des informations pertinentes pour le projet à partir duquel les rapports sont créés.
  :current_domain_name | Renvoie les informations pertinentes pour le domaine à partir duquel le rapport est créé.

- Sélectionnez Top. Cette option vous permet de limiter les résultats de la requête à un nombre défini d’éléments.

Retour en haut

## Fonctions prises en charge

Le tableau suivant énumère les fonctions DQL qui sont prises en charge par ALM. Les fonctions DQL sont converties en fonctions SQL correspondantes pour être utilisées dans la base de données. Le tableau présente les conversions des fonctions DQL vers MS SQL et Oracle. Pour plus de détails, reportez-vous à la documentation MS SQL et Oracle.

Agrégation

Fonction | Signature | Type de retour | Description
--- | --- | --- | ---
count | count(expression) | integer | Renvoie le nombre de lignes dans une requête.
count_big | count_big(expression) | integer (bigint) | Renvoie le nombre de lignes dans une requête. La seule différence entre count et count_big est leur valeur de retour. Dans MS SQL, count_big renvoie toujours une valeur de type bigint, et count renvoie toujours une valeur de type int. Dans Oracle, la fonction est convertie en count.
variance | variance(décimale) | décimale | Renvoie la variance de l’expression. Dans MS SQL, la fonction est convertie en var. Dans Oracle, la fonction est codée comme round(variance(<decimal>), 14).
var_pop | var_pop(expression) | décimale | Renvoie la variance de population d’un ensemble de nombres après avoir éliminé les nombres nuls de l’ensemble. Dans MS SQL, la fonction est convertie en varp. Dans Oracle, la fonction est codée comme round(var_pop(<expression>), 14).
stddev | stddev(decimal) | décimale | Renvoie l’écart type d’un ensemble de nombres. Dans MS SQL, la fonction est convertie en stdev. Dans Oracle, la fonction est codée comme round(stddev(<decimal>), 14).
stddev_pop | stddev_pop(expression) | décimale | Calcule l’écart-type de la population et renvoie la racine carrée de la variance de la population. Dans MS SQL, la fonction est convertie en stdevp. Dans Oracle, la fonction est codée comme round(stddev_pop(<expression>), 14).
avg | avg(expression) | décimale | Renvoie la valeur moyenne d’une expression. Dans Oracle, la fonction est codée comme round(avg(<decimal>), 14).
sum | sum(decimal) | décimale | Renvoie la valeur additionnée d’une expression.
min | min(expression) | expression | Renvoie la valeur minimale d’une expression.
max | max(expression) | expression | Renvoie la valeur maximale d’une expression.

Manipulation des chaînes

Fonction | Signature | Type de retour | Description
--- | --- | --- | ---
upper | upper(string) | string | Renvoie la chaîne de caractères donnée avec toutes les lettres converties en majuscules.
lower | lower(string) | string | Renvoie la chaîne de caractères donnée avec toutes les lettres converties en minuscules.
rtrim | rtrim(string) | string | Renvoie la chaîne de caractères donnée avec tous les espaces de queue supprimés du côté droit.
ltrim | ltrim(String) | string | Renvoie la chaîne de caractères donnée avec tous les espaces de tête supprimés.
replace | replace(string, string_to_replace, replacement_string) | string | Renvoie la chaîne donnée avec toutes les séquences de <string_to_replace> remplacées par <replacement_string>.
substring | substring(string, int_start_position, int_length) | string | Renvoie une sous-chaîne de la chaîne de caractères donnée. int_start_position. La position à partir de laquelle il faut commencer à extraire la sous-chaîne. int_length. Le nombre de caractères à extraire. Dans Oracle, la fonction est convertie en substr.
length | length(string) | décimale | Renvoie la longueur de la chaîne de caractères spécifiée. Dans MS SQL, la fonction est convertie en len.
chr | chr(integer) | string | Convertit un code ASCII int en un caractère. Dans MS SQL, la fonction est convertie en char.
soundex | soundex(string) | string | Renvoie une représentation phonétique d’une chaîne de caractères.
ascii | ascii(string) | integer | Renvoie la valeur du code ASCII du caractère le plus à gauche d’une expression de caractères.
concat | concat(string1, string2) | string | Concatène deux chaînes de caractères ensemble. Dans MS SQL, la fonction est convertie en +, et la fonction est codée en tant que <string1>+<string2>.
leftstr | leftstr(string, integer) | string | Renvoie la partie gauche d’une chaîne de caractères avec le nombre de caractères spécifié. Dans MS SQL, la fonction est convertie en left. Dans Oracle, la fonction est convertie en substr et est codée comme substr(<string>, 1,<integer>).
lpad | lpad(string1, integer, string2) | string | Retourne <string1>une séquence de caractères de longueur <integer>, avec un remplissage à gauche, avec la séquence de caractères dans le tableau suivant <string2>. Cette fonction est utile pour formater la sortie d’une requête. Dans MS SQL, la fonction est convertie en expression de remplissage à gauche, qui met en œuvre la logique ci-dessus.
reverse | reverse(string) | string | Renvoie l’inverse d’une valeur de type chaîne. Dans Oracle, la fonction est codée comme reverse(to_char(<string>)).
rightstr | rightstr(string, integer) | string | Renvoie la partie droite d’une chaîne de caractères avec le nombre de caractères spécifié. Dans MS SQL, la fonction est convertie en right. Dans Oracle, la fonction est convertie en substr avec l’expression de la partie droite, qui met en œuvre la logique ci-dessus.
rpad | rpad(string1, integer, string2) | string | Retourne <string1>, avec des caractères de longueur <integer> et un remplissage à droite avec <string2>répliqué autant de fois que nécessaire. Cette fonction est utile pour formater la sortie d’une requête. Dans MS SQL, la fonction est convertie enà left avec l’expression de right padding, ce qui met en œuvre la logique ci-dessus.
stuff | stuff(string, integer, integer, string) | string | Insère une chaîne dans une autre chaîne. Elle supprime une longueur spécifiée de caractères dans la première chaîne à la position de départ, puis insère la deuxième chaîne dans la première chaîne à la position de départ. Dans Oracle, la fonction stuff est convertie en une expression qui met en œuvre la logique ci-dessus.
in_string | in_string(string1, string2, integer_start_location) | integer | Renvoie l’emplacement de la sous-chaîne string1 dans string2, si elle existe. Sinon, il renvoie 0. La recherche commence à integer_start_location, qui commence à 1. Dans MS SQL, la fonction est convertie en charindex. Dans Oracle, la fonction est convertie en instr et est codée comme instr(<string2>,<string1>, <integer_start_location>).
replicate | replicate(string, integer) | string | Répète la valeur <string> le nombre de fois indiqué dans le paramètre <integer>. Dans Oracle, la fonction est convertie en rpad et est codée comme rpad(<string>, length(<string>*<integer>), <string>).

Mathématiques

Fonction | Signature | Type de retour | Description
--- | --- | --- | ---
sin | sin(decimal) | décimale | Renvoie le sinus du paramètre decimal. Dans Oracle, la fonction est codée comme round(sin(<decimal>), 14).
asin | asin(decimal) | décimale | Renvoie l’arc sinus du paramètre decimal. L’argument doit être compris entre -1 et 1. Dans Oracle, la fonction est codée comme round(asin(<decimal>), 14).
cos | cos(decimal) | décimale | Renvoie le cosinus du paramètre decimal. In Oracle, the function is coded as round(cos(<decimal>), 14).
acos | acos(decimal) | décimale | Renvoie l’arc cosinus du paramètre decimal. L’argument doit être compris entre -1 et 1. Dans Oracle, la fonction est codée comme round(acos(<decimal>), 14).
tan | tan(decimal) | décimale | Renvoie la tangente du paramètre decimal. Dans Oracle, la fonction est codée comme round(tan(<decimal>), 14).
atan | atan(decimal) | décimale | Renvoie l’arc tangent du paramètre decimal. Dans Oracle, la fonction est codée comme round(atan(<decimal>), 14).
atan2 | atan2(decimal1, decimal2) | décimale | Renvoie l’angle, en radians, entre l’axe x positif et le rayon allant de l’origine au point (y, x), où x et y sont les valeurs de decimal1 et decimal2. Dans MS SQL, la fonction est convertie en atn2. Dans Oracle, la fonction est codée comme round(atan2(<decimal1>), 14).
tanh | tanh(decimal) | décimale | Renvoie la tangente hyperbolique du paramètre decimal. Dans MS SQL, la fonction est convertie en expression tanh, qui met en œuvre la logique ci-dessus. Dans Oracle, la fonction est codée comme round(tanh(<decimal>), 14).
sqrt | sqrt(decimal) | décimale | Renvoie la racine carrée des paramètres décimaux. Dans Oracle, la fonction est codée comme round(sqrt(<decimal>), 14).
exp | exp(decimal) | décimale | Renvoie e élevé à la puissance du paramètre decimal, où e = 2,71828183. Dans Oracle, la fonction est codée comme round(exp(<decimal>), 14).
sign | sign(decimal) | décimale | Renvoie une valeur indiquant le signe d’un nombre. Si le nombre est < 0, alors le sign renvoie -1. Si le nombre = 0, alors le sign renvoie 0. Si le nombre > 0, alors sign renvoie 1. Dans MS SQL, la fonction est convertie en expression de signe, qui met en œuvre la logique ci-dessus, et est codée comme CAST(sign(<decimal>) AS int).
floor | floor(decimal) | integer | Renvoie le plus grand nombre entier inférieur ou égal à l’argument decimal spécifié.
ln | ln(decimal) | décimale | Renvoie le logarithme naturel de l’argument decimal. Dans MS SQL, la fonction est convertie en log. Dans Oracle, la fonction est codée comme round(ln(<decimal>), 14).
abs | abs(decimal) | décimale | Renvoie la valeur absolue d’un nombre.
round | round(decimal, integer) | décimale | Renvoie les décimales arrondies aux nombres entiers à droite de la virgule. Le paramètre integer peut être négatif pour arrondir les chiffres à gauche du point décimal. En MS SQL, la fonction est codée comme CAST(round(<decimal>,<integer>) AS int) ou comme CAST(round(<decimal>,<integer>) AS float), selon que le nombre entier est évalué à zéro ou non.
mod | mod(decimal1, decimal2) | décimale | Renvoie le reste de decimal1 divisé par decimal2. Dans MS SQL, la fonction est convertie en % et est codée comme suit <decimal1>%<decimal2>.
trunc_number | trunc_number(decimal, integer) | décimale | Renvoie decimal tronquées à des décimales integer. Si integer est omis, alors decimal est tronquée à 0 place. Dans MS SQL, la fonction est convertie en expression de truncation, qui met en œuvre la logique ci-dessus. Dans Oracle, la fonction est convertie en trunc.
str | str(decimal, integer1, integer2) | string | Renvoie des données de type caractère converties à partir de données numériques. Dans Oracle, la fonction est convertie en expression de string construction, qui met en œuvre la logique ci-dessus.
ceil | ceil(decimal) | décimale | Renvoie le plus petit nombre entier supérieur ou égal au paramètre décimal. Dans MS SQL, la fonction est convertie en ceiling.

Cast

Fonction | Signature | Type de retour | Description
--- | --- | --- | ---
to_number | to_number(string) | décimale | Convertit une chaîne de caractères en un nombre. En MS SQL, la fonction est codée comme CAST(<string>AS float).
number_to_char | number_to_char(decimal) | string | Convertit un nombre en une chaîne de caractères. En MS SQL, la fonction est codée comme CAST(<decimal>AS varchar(50)). Dans Oracle, la fonction est convertie en to_char.
char_to_char | char_to_char(string) | string | Convertit les données NCHAR, NVARCHAR2, CLOB ou NCLOB en jeu de caractères de la base de données. En MS SQL, la fonction est codée comme CAST(<string>AS varchar(50)). Dans Oracle, la fonction est convertie en to_char.
datetime_to_char | datetime_to_char(expression) | string | Convertit une date ou une heure en une chaîne de caractères. En MS SQL, la fonction est codée comme convert(varchar,<date>, 121). Dans Oracle, la fonction est convertie en to_char et est codée comme to_char(<date>, 'YYYY-MM-DD HH24:MI:SS:FF3').

Divers

Fonction | Signature | Type de retour | Description
--- | --- | --- | ---
nullif | nullif(expression1, expression2) | expression | Compare l’expression1 et l’expression2. Si l’expression1 et l’expression2 sont égales, la fonction renvoie NULL. Sinon, il renvoie l’expression1.
coalesce | coalesce() | expression | Retourne la première expression non nulle parmi ses arguments. Le type de données de la valeur retournée est le type de données du paramètre ayant la plus haute priorité de type de données.
isnull | isnull(check_expression, replace_expression) | expression | Substitue une valeur lorsqu’une valeur nulle est rencontrée. Si check_expression est nul, alors la fonction renvoie replace_expression. Dans Oracle, la fonction est convertie en nvl.

Date

Fonction | Signature | Type de retour | Description
--- | --- | --- | ---
currentdate | currentdate() | date | Renvoie la date du jour. En MS SQL, la fonction est codée comme CAST(CAST(getdate() AS date) AS datetime). Dans Oracle, la fonction est codée comme to_date(to_char(sysdate)).
dateadd | dateadd(integer, date) | date | Ajoute des paramètres de jours à date : integer. Le nombre de jours à ajouter. date. La date à ajouter. En MS SQL, la fonction est codée comme dateadd(DAY, <int days>, <Date date>). Dans Oracle, la fonction est convertie en + et est codée comme suit <int days> + <Date date>.
datediff | datediff(start_date, end_date) | integer | Renvoie le nombre (nombre entier signé) de dates croisées entre start_date et end_date spécifiées. En MS SQL, la fonction est codée comme datediff(DAY,<date>,<date>). Dans Oracle, la fonction est convertie en - et est codée comme trunc(<date>-<date>, 0).
get_time | get_time() | datetime | Renvoie la date et l’heure actuelles. Dans MS SQL, la fonction est convertie en getdate et est codée comme convert(datetime, getdate(), 126). Dans Oracle, la fonction est convertie en LOCALTIMESTAMP.
trunc_date | trunc_date(date, string_format) | date | Retourne une date tronquée à une unité de mesure spécifique. string_format est l’unité de mesure à appliquer pour la troncature. Les formats suivants sont pris en charge : année, y, aa, aaaa, q, trimestre, mm, mois, j, jj, jour, hh, mi Dans MS SQL, la fonction est convertie en dateadd et est codée comme dateadd(<unquoted string_format>, datediff(<unquoted string_format>, 0,<date>), 0). Dans Oracle, la fonction est convertie en trunc et est codée comme trunc(<date>, <string_format>.
to_date | to_date(string) | date | Convertit une chaîne de caractères en date. En MS SQL, la fonction est codée comme CAST(<string>AS datetime). Dans Oracle, la fonction est codée comme to_date(<string>, 'YYYY-MM-DD').
timestamp_tz | timestamp_tz() | string | Renvoie le fuseau horaire actuel du serveur. Dans MS SQL, la fonction est convertie en sysdatetimeoffset. Dans Oracle, la fonction est convertie en CURRENT_TIMESTAMP. Cette fonction n’est pas prise en charge par MS SQL Server 2005.
from_tz | from_tz(date, string) | date | Convertit une valeur d’horodatage (date) et un fuseau horaire (string) en un horodatage avec valeur de fuseau horaire. Dans MS SQL, la fonction est convertie en expressions d’horodatage et de zone, qui mettent en œuvre la logique ci-dessus. Cette fonction n’est pas prise en charge par MS SQL Server 2005.
sysdatetimeoffset | sysdatetimeoffset() | datetime avec fuseau horaire | Renvoie la date système, y compris les fractions de seconde, et le fuseau horaire du système sur lequel réside la base de données. Dans Oracle, la fonction est convertie en SYSTIMESTAMP. Cette fonction n’est pas prise en charge par MS SQL Server 2005.
getyear | getyear(date) | integer | Renvoie un nombre entier qui représente l’année de la date spécifiée. Dans MS SQL, la fonction est convertie en year. Dans Oracle, la fonction est convertie en to_char et est codée comme CAST(to_char(<date>, 'yyyy') AS number).
getmonth | getmonth(date) | integer | Renvoie un nombre entier qui représente le mois de la date spécifiée. Dans MS SQL, la fonction est convertie en month. Dans Oracle, la fonction est convertie en to_char et est codée comme CAST(to_char(<date>, 'mm') AS number).
getday | getday(date) | integer | Renvoie un nombre entier représentant le jour du mois de la date spécifiée. Dans MS SQL, la fonction est convertie en day. Dans Oracle, la fonction est convertie en to_char et est codée comme CAST(to_char(<date>, 'dd') AS number).
datepart | datepart(string_datepart, date) | integer | Renvoie un nombre entier qui représente string_datepart spécifiée de la date spécifiée. En MS SQL, la fonction est codée comme datepart(<unquoted string_datepart>,<date>). Dans Oracle, la fonction est convertie en expression datepart, qui met en œuvre la logique ci-dessus.
datename | datename(string_datepart, date) | string | Renvoie une chaîne de caractères qui représente string_datepart spécifiée de la date spécifiée. Les formats suivants sont pris en charge : aaaa, aa, année, q, trimestre, m, mois, j, jj, jour, hh, mi En MS SQL, la fonction est codée comme datename(<unquoted string_datepart>,<date>). Dans Oracle, la fonction est convertie en expression datename, qui met en œuvre la logique ci-dessus.

Date spéciale

Note : Pour chaque fonction, la date demandée est renvoyée dans le format de date correspondant. Dans MS SQL, la date demandée au format aaaa-MM-jj est convertie en datetime. Dans Oracle, to_date(<requested date in jj-MMM-aa format>, DD-MON-YY)

Fonction | Signature | Type de retour | Description
--- | --- | --- | ---
firstDayOfCurrentMonth | firstDayOfCurrentMonth() | date | Renvoie la date du premier jour du mois en cours.
firstDayOfCurrentWeek | firstDayOfCurrentWeek() | date | Renvoie la date du premier jour de la semaine en cours.
firstDayOfCurrentYear | firstDayOfCurrentYear() | date | Renvoie la date du premier jour de l’année en cours.
firstDayOfNextMonth | firstDayOfNextMonth() | date | Renvoie la date du premier jour du mois suivant.
firstDayOfNextWeek | firstDayOfNextWeek() | date | Renvoie la date du premier jour de la semaine suivante.
firstDayOfNextYear | firstDayOfNextYear() | date | Renvoie la date du premier jour de l’année suivante.
firstDayOfPreviousMonth | firstDayOfPreviousMonth() | date | Renvoie la date du premier jour du mois précédent.
firstDayOfPreviousWeek | firstDayOfPreviousWeek() | date | Renvoie la date du premier jour de la semaine précédente.
firstDayOfPreviousYear | firstDayOfPreviousYear() | date | Renvoie la date du premier jour de l’année précédente.
lastDayOfCurrentMonth | lastDayOfCurrentMonth() | date | Renvoie la date du dernier jour du mois en cours.
lastDayOfCurrentWeek | lastDayOfCurrentWeek() | date | Renvoie la date du dernier jour de la semaine en cours.
lastDayOfCurrentYear | lastDayOfCurrentYear() | date | Renvoie la date du dernier jour de l’année en cours.
lastDayOfNextMonth | lastDayOfNextMonth() | date | Renvoie la date du dernier jour du mois suivant.
lastDayOfNextWeek | lastDayOfNextWeek() | date | Renvoie la date du dernier jour de la semaine suivante.
lastDayOfNextYear | lastDayOfNextYear() | date | Renvoie la date du dernier jour de l’année suivante.
lastDayOfPreviousMonth | lastDayOfPreviousMonth() | date | Renvoie la date du dernier jour du mois précédent.
lastDayOfPreviousWeek | lastDayOfPreviousWeek() | date | Renvoie la date du dernier jour de la semaine précédente.
lastDayOfPreviousYear | lastDayOfPreviousYear() | date | Renvoie la date du dernier jour de l’année précédente.

Case

Fonction | Signature | Type de retour | Description
--- | --- | --- | ---
decode | decode(expression, search, result [, search, result]... [, default] ) | expression | Renvoie la fonctionnalité d’une instruction IF-THEN-ELSE. Compare l’expression à chaque valeur recherchée, une par une. Si l’expression est égale à une recherche, Oracle renvoie le résultat correspondant. Si aucune correspondance n’est trouvée, Oracle renvoie default. Si la valeur par défaut est omise, Oracle renvoie null. Dans MS SQL, la fonction est convertie en expression case-when-else, qui met en œuvre la logique ci-dessus.
greatest | greatest() | expression | Retourne le plus grand de la liste des paramètres. Dans MS SQL, la fonction est convertie en l’expression greatest, qui met en œuvre la logique ci-dessus.
least | least() | expression | Renvoie le plus petit de la liste des paramètres. Dans MS SQL, la fonction est convertie en l’expression least, qui met en œuvre la logique ci-dessus.

Retour en haut

https://admhelp.microfocus.com ALM 8942
Conseils pour améliorer vos résultats de recherche... ALM Help Center ALM Help Center Aide ALM 17.0 Tout Afficher le centre d’aide local Afficher le centre d’aide en ligne arrière Revenir en arrière dans l’historique de navigation avant Avancer dans l’historique de navigation Désactiver la mise en surbrillance dans les résultats de recherche rubrique suivante Atteindre la rubrique suivante rubrique précédente Atteindre la rubrique précédente Imprimer la rubrique actuelle Version :