Ébauche de requête

Le mode Ébauche de requête permet de créer et d'éditer une requête de base de données.

Pour accéder à cette commande...

Dans une fenêtre de fichier de base de données, cliquez sur l'icône Requêtes, puis cliquez sur Édition - Éditer.


Icône Remarque

La plupart des bases de données utilisent des requêtes pour filtrer ou trier les tables de base de données, ou bien pour afficher les enregistrements à l'écran. Les vues offrent les mêmes fonctionnalités que les requêtes, mais côté serveur. Si votre base de données se trouve sur un serveur qui prend en charge les vues, vous pouvez utiliser ces dernières pour filtrer les enregistrements stockés sur le serveur et accélérer le temps d'affichage.


Icône Remarque

Sélectionner la commande Créer une vue dans l'onglet Tables d'un document de base de données permet d'afficher la fenêtre Ébauche de vue, similaire à la fenêtre Ébauche de requête décrite ici.


La mise en page de la fenêtre Ébauche de requête est enregistrée avec une requête créée mais ne peut pas être enregistrée avec une vue créée.

Mode Ébauche

Pour créer une requête, cliquez sur l'icône Requêtes dans un document de base de données, puis sur Créer une requête en mode Ébauche.

The lower pane of the Design View is where you define the query. To define a query, specify the database field names to include and the criteria for displaying the fields. To rearrange the columns in the lower pane of the Design View, drag a column header to a new location, or select the column and press +arrow key.

Les icônes des barres Ébauche de requête et Ébauche s'affichent en haut de la fenêtre du mode Ébauche de requête.

Si vous souhaitez tester une requête, double-cliquez sur le nom de la requête dans le document de base de données. Le résultat de la requête s'affiche dans une table similaire à la vue des sources de données. Remarque : la table affichée est temporaire.

Touches en mode Ébauche de requête

Touche

Fonction

F4

Aperçu

F5

Exécuter la requête

F7

Ajouter une table ou une requête


Parcourir

Lorsque vous ouvrez l'ébauche de requête pour la première fois, vous voyez une boîte de dialogue dans laquelle vous devez d'abord sélectionner la table ou la requête qui sera la base de votre nouvelle requête.

Double-cliquez sur les champs à ajouter à la requête. Définissez des relations par glisser-déposer.

Icône Remarque

Lorsque vous concevez une requête, vous ne pouvez pas modifier les tables sélectionnées.


Supprimer des tables

Pour supprimer une table de la fenêtre d'ébauche, cliquez sur le bord supérieur de la fenêtre des tables, activez le menu contextuel et sélectionnez la commande Supprimer. Vous pouvez également utiliser la touche Suppr.

Déplacer une table et modifier la taille de la table

Vous pouvez organiser les tables à votre gré et en modifier la taille. Pour déplacer une table, cliquez sur le bord supérieur et faites-la glisser jusqu'à la position voulue. Pour agrandir ou réduire l'affichage, faites glisser un bord ou un angle de la table.

Relations de table

S'il y a des relations de données entre un nom de champ dans une table et un nom de champ dans une autre table, vous pouvez utiliser ces relations dans votre requête.

If, for example, you have a spreadsheet for articles identified by an article number, and a spreadsheet for customers in which you record all articles that a customer orders using the corresponding article numbers, then there is a relationship between the two "article number" data fields. If you now want to create a query that returns all articles that a customer has ordered, you must retrieve data from two spreadsheets. To do this, you must inform LibreOfficeDev about the relationship which exists between the data in the two spreadsheets.

To do this, click a field name in a table (for example, the field name "Item-Number" from the Customer table), hold down the mouse button and then drag the field name to the field name of the other table ("Item-Number" from the Item table). When you release the mouse button, a line connecting the two fields between the two table windows appears. The corresponding condition that the content of the two field names must be identical is entered in the resulting SQL query.

La création d'une requête basée sur plusieurs feuilles liées n'est possible que si vous utilisez LibreOfficeDev en tant qu'interface pour une base de données relationnelle telle qu'Adabas.

Icône Remarque

Vous ne pouvez pas accéder aux tables de plusieurs bases de données dans une requête. Les requêtes impliquant plusieurs tables ne peuvent être créées que dans une seule base de données.


Specifying the relation type

If you double-click on the line connecting two linked fields or call the menu command Insert - New Relation, you can specify the type of relation in the Relations dialog.

Vous pouvez également appuyer sur la touche Tabulation jusqu'à ce que la ligne de jointure soit sélectionnée (elle s'affiche agrandie). Appuyez ensuite sur Maj+F10 pour afficher le menu contextuel et choisissez la commande Éditer. Certaines bases de données ne prennent en charge que certains sous ensembles possibles de types de jointures.

Supprimer les relations

Pour supprimer une relation entre deux tables, cliquez sur la ligne de connexion puis appuyez sur la touche Suppr.

Vous pouvez également supprimer les entrées respectives dans la zone Champs utilisés de la boîte de dialogue Relations. Vous pouvez aussi appuyer sur la touche Tabulation jusqu'à ce que le vecteur de connexion soit mis en évidence, puis appuyer sur Maj+F10 pour ouvrir le menu contextuel et sélectionner la commande Supprimer.

Defining the query

Sélectionnez les conditions de définition de votre requête. Toutes les colonnes de la table d'ébauche acceptent des champs de données pour les requêtes. Les conditions d'une ligne donnée sont liées par un ET logique.

Specifying field names

First, select all field names from the tables that you want to add to the query. You can do this either by drag-and-drop or by double-clicking a field name in the table window. With the drag-and-drop method, use the mouse to drag a field name from the table window into the lower area of the query design window. As you do this, you can decide which column in the query design window will receive the selected field. A field name can also be selected by double-clicking. It will then be added to the next free column in the query design window.

Supprimer les noms de champ

Pour supprimer un nom de champ de la requête, cliquez sur l'en-tête de la colonne du champ, puis choisissez la commande Supprimer du menu contextuel de la colonne.

Saving the query

Use the Save icon on the Standard toolbar to save the query. You will see a dialog that asks you to enter a name for the query. If the database supports schemas, you can also enter a schema name.

Schéma

Saisissez le nom du schéma auquel doit être assignée la requête ou la vue de table.

Nom de la requête ou de la vue de table

Saisissez le nom de la requête ou vue de table.

Filtrer les données

To filter data for the query, set the desired criteria in the lower area of the query design window. The following options are available:

Champ

Enter the name of the data field that is referred to in the Query. All settings made in the filter option rows refer to this field. If you activate a cell here with a mouse click you'll see an arrow button, which enables you to select a field. The "Table name.*" option selects all data fields with the effect that the specified criteria will be applied to all table fields.

Alias

Specifies an alias. This alias will be listed in the query instead of the field name. This makes it possible to use user-defined column labels. For example, if the data field is named PtNo and, instead of that name, you would like to have PartNum appear in the query, enter PartNum as the alias.

In a SQL statement, aliases are defined as follows:

SELECT column AS alias FROM table.

Par exemple :

SELECT "NoArticle" AS Numéro-article FROM "Articles"

Table

The corresponding database table of the selected data field is listed here. If you activate this cell with a mouse click, an arrow will appear which enables you to select a different table for the current query.

Trier

If you click on this cell, you can choose a sort option: ascending, descending and unsorted. Text fields will be sorted alphabetically and numerical fields numerically. For most databases, administrators can set the sorting options at the database level.

Visible

If you mark the Visible property for a data field, that field will be visibly displayed in the resulting query. If you are only using a data field to formulate a condition or make a calculation, you do not necessarily need to display it.

Critères

Specifies a first criteria by which the content of the data field is to be filtered.

ou

Here you can enter one additional filter criterion for each line. Multiple criteria in a single column will be interpreted as boolean OR.

You can also use the context menu of the line headers in the lower area of the query design window to insert a filter based on a function:

Fonctions

The functions which are available here depend on those provided by the database engine.

If you are working with the embedded HSQL database, the list box in the Function row offers you the following options:

Option

SQL

Effet

Aucune fonction

Aucune fonction n'est exécutée.

Moyenne

AVG

Calcule la moyenne arithmétique d'un champ.

Nombre

COUNT

Determines the number of records in the table. Empty fields can either be counted (a) or excluded (b).

a) COUNT(*) : Lorsque vous fournissez un astérisque en guise d'argument, tous les enregistrements de la table sont comptés.

b) COUNT(column): Passing a field name as an argument counts only those records for fields in which the field name in question contains a value. Records with fields having Null values (i.e. fields containing no characters) will not be counted.

Maximum

MAX

Determines the highest value of a record for that field.

Minimum

MIN

Determines the lowest value of a record for that field.

Somme

SUM

Calculates the sum of the values of records for the associated fields.

Grouper

GROUP BY

Groups query data according to the selected field name. Functions are executed according to the specified groups. In SQL, this option corresponds to the GROUP BY clause. If a criterion is added, this entry appears in the SQL HAVING sub-clause.


Vous pouvez également saisir des appels de fonctions directement dans l'instruction SQL. La syntaxe est la suivante :

SELECT FUNCTION(column) FROM table.

Par exemple, l'appel de fonction permettant de calculer une somme se présentera comme suit dans SQL :

SELECT SUM("Prix") FROM "Articles".

Except for the Group function, the above functions are called Aggregate functions. These are functions that calculate data to create summaries from the results. Additional functions that are not listed in the list box might be also possible. These depend on the specific database engine in use and on the current functionality provided by the Base driver used to connect to that database engine.

To use other functions not listed in the list box, you must enter them manually under Field.

You can also assign aliases to function calls. If you not wish the query string to be displayed in the column header, enter a desired substitute name under Alias.

Dans une instruction SQL, l'appel de fonction correspondant se présente comme suit :

SELECT FUNCTION() AS alias FROM table

Exemple :

SELECT COUNT(*) AS Nombre FROM "Articles"

Icône Remarque

If you run such a function, you cannot insert any additional columns for the query other than as an argument in a "Group" function.


Exemples

Dans l'exemple suivant, une requête portant sur deux tables est exécutée : une table "Articles" contenant le champ "No_article" et une table "Fournisseurs" contenant le champ "Nom_fournisseur". Par ailleurs, les deux tables possèdent un champ commun, en l'occurrence "No_fournisseur"

Pour créer une requête contenant tous les fournisseurs qui livrent plus de trois articles, les étapes suivantes sont nécessaires.

  1. Insérer les tables "Articles" et "Fournisseurs" dans l'ébauche de requête.

  2. Lier les champs "No_fournisseur" des deux tables, au cas où il n'existe pas déjà de relation de ce type entre les deux tables.

  3. Double-click on the "Item_No" field from the "Item" table. Display the Function line using the context menu and select the Count function.

  4. Entrer le critère >3 et désactiver l'option Visible.

  5. Double-cliquer sur le champ "Nom_fournisseur" de la table "Fournisseurs" et sélectionner la fonction Groupement.

  6. Exécutez la requête.

Si la table "Articles" contient les champs "Prix" (prix unitaire de chaque article) et "No_fournisseur" (désignant le fournisseur de l'article), la requête suivante vous permet de calculer le prix moyen des articles proposés par un fournisseur :

  1. Insérer la table "Articles" dans l'ébauche de requête.

  2. Double-cliquer sur les champs "Prix" et "No_fournisseur".

  3. Activer la ligne Fonction et sélectionner la fonction Moyenne pour le champ "Prix".

  4. Si vous le souhaitez, vous pouvez entrer l'alias de "Moyenne" sur la ligne (sans les guillemets).

  5. Sélectionner la fonction Groupement pour le champ "No_fournisseur".

  6. Exécutez la requête.

Voici les commandes de menu contextuel et les icônes disponibles :

Fonctions

Shows or hides a row for the selection of functions.

Nom de la table

Affiche ou masque la ligne pour le nom de table.

Nom d'alias

Affiche ou masque la ligne pour l'alias.

Valeurs distinctes

Retrieves only distinct values from the query. This applies to multiple records that might contain several repeating occurrences of data in the selected fields. If the Distinct Values command is active, you should only see one record in the query (DISTINCT). Otherwise, you will see all records corresponding to the query criteria (ALL).

Par exemple, si le nom "Martin" est présent plusieurs fois dans votre base de données d'adresses, vous pouvez choisir la commande Valeurs distinctes pour indiquer dans la requête que le nom "Martin" ne doit s'afficher qu'une seule fois.

Pour une requête utilisant plusieurs champs, la combinaison des valeurs provenant de tous les champs doit être unique afin que le résultat puisse être constitué à partir d'un enregistrement spécifique. Un carnet d'adresses peut contenir, par exemple, une occurrence de "Martin de Brest" et deux occurrences de "Martin de Paris". Si la commande Valeurs distinctes est utilisée, la requête utilise les champs "nom" et "ville", et son résultat contient une fois "Martin de Brest" et une fois "Martin de Paris".

En SQL, cette commande correspond au prédicat DISTINCT.

Limite

Allows you to limit the maximum number of records returned by a query.

If a Limit construction is added, you will get at most as many rows as the number you specify. Otherwise, you will see all records corresponding to the query criteria.

Formuler les conditions de filtrage

When formulating filter conditions, various operators and commands are available to you. Apart from the relational operators, there are SQL-specific commands that query the content of database fields. If you use these commands in the LibreOfficeDev syntax, LibreOfficeDev automatically converts these into the corresponding SQL syntax via an internal parser. You can also enter the SQL command directly and bypass the internal parser. The following tables give an overview of the operators and commands:

Opérateur

Signification

La condition est remplie si...

=

égal à

... le contenu du champ est identique à l'expression entrée.

The operator = will not be displayed in the query fields. If you enter a value without any operator, the = operator is automatically assumed.

<>

différent de

... le contenu du champ ne correspond pas à l'expression spécifiée.

>

supérieur à

... le contenu du champ est supérieur à l'expression spécifiée.

<

inférieur à

... le contenu du champ est inférieur à l'expression spécifiée.

>=

supérieur ou égal à

... le contenu du champ est supérieur ou égal à l'expression spécifiée.

<=

inférieur ou égal à

... le contenu du champ est inférieur ou égal à l'expression spécifiée.


Commande LibreOfficeDev

Instruction SQL

Signification

La condition est remplie si...

IS EMPTY

IS NULL

est nul

... the field contains no data. For Yes/No fields with three possible states, this command automatically queries the undetermined state (neither Yes nor No).

IS NOT EMPTY

IS NOT NULL

n'est pas vide

... the field is not empty, i.e it contains data.

LIKE

placeholder (*) for any number of characters

placeholder (?) for exactly one character

LIKE

placeholder (%) for any number of characters

Placeholder (_) for exactly one character

appartient à

... the data field must contain the indicated search string in the order given. The position of the (*) placeholder indicates whether the searched for string (x) occurs before the placeholder (x*), after the placeholder (*x) or between the placeholders (*x*). Instead of the familiar file system (*) placeholder, you can also use the SQL (%) character as a placeholder in SQL queries in the LibreOfficeDev interface.

The (*) or (%) placeholder stands for any number of characters. The question mark (?) in the LibreOfficeDev interface or the underscore (_) in SQL queries is used to represent exactly one character.

NOT LIKE

NOT LIKE

N'appartient pas à

... the field does not contain data having the specified expression.

BETWEEN x AND y

BETWEEN x AND y

compris dans l'intervalle [x,y]

... the field contains a data value that lies between the two values x and y.

NOT BETWEEN x AND y

NOT BETWEEN x AND y

Non compris dans l'intervalle [x,y]

... the field contains a data value that does not lie between the two values x and y.

IN (a; b; c...)

Note that semicolons are used as separators in all value lists!

IN (a, b, c...)

contient a, b, c...

... the field name contains one of the specified expressions a, b, c,... Any number of expressions can be specified, and the result of the query is determined by a boolean OR operator. The expressions a, b, c... can be either numbers or characters

NOT IN (a; b; c...)

NOT IN (a, b, c...)

ne contient pas a, b, c...

... the field does not contain one of the specified expressions a, b, c,...

= TRUE

= TRUE

a la valeur Vrai

... le champ de données contient la valeur Vrai.

= FALSE

= FALSE

a la valeur faux

... the field data value is set to false.


Exemples

='Ms.'

renvoie les champs de données contenant l'expression "Madame"

<'2001-01-10'

renvoie les dates antérieures au 10 janvier 2001

LIKE 'g?ve'

returns records with field content such as "give" and "gave".

LIKE 'S*'

returns records with field contents such as "Sun".

BETWEEN 10 AND 20

returns records with field content between the values 10 and 20. (The fields can be either text fields or number fields).

IN (1; 3; 5; 7)

returns records with the values 1, 3, 5, 7. If the field name contains an item number, for example, you can create a query that returns the item having the specified number.

NOT IN ('Smith')

returns records that do not contain "Smith".


Like Escape Sequence: {escape 'escape-character'}

Exemple : select * from Article where NomArticle like 'The *%' {escape '*'}

L'exemple renvoie toutes les entrées dont le nom de l'article commence par 'The *'. Ceci vous permet donc de rechercher des caractères (interprétés dans d'autres cas comme substituants) tels que *, ?, _, % ou le point.

Outer Join Escape Sequence: {oj outer-join}

Exemple : select Article.* from {oj Article LEFT OUTER JOIN Commandes ON NoArticle=Commandes.NOA}

Interroger les champs de texte

To query the content of a text field, you must put the expression between single quotes. The distinction between uppercase and lowercase letters depends on the database in use. LIKE, by definition, is case-sensitive (though some databases don't interpret this strictly).

Interroger les champs de date

champs Date sont représentés sous la forme #Date# pour les identifier clairement comme des dates. Les constantes (expressions littérales) Date, Heure et Date&Heure utilisées dans des conditions peuvent être de type syntaxe d'échappement SQL ou syntaxe SQL2 par défaut.

Élément de type Date

Syntaxe d'échappement SQL #1 - peut-être obsolète

Syntaxe d'échappement SQL #2

Syntaxe SQL2

Date

{D'YYYY-MM-DD'}

{d 'YYYY-MM-DD'}

'YYYY-MM-DD'

Heure

{D'HH:MM:SS'}

{t 'HH:MI:SS[.SS]'}

'HH:MI:SS[.SS]'

Date et heure

{D'YYYY-MM-DD HH:MM:SS'}

{ts 'YYYY-MM-DD HH:MI:SS[.SS]'}

'YYYY-MM-DD HH:MI:SS[.SS]'


Exemple : select {d '1999-12-31'} from world.years

Exemple : select * from ma_table where annees='1999-12-31'

All date expressions (date literals) must be enclosed with single quotation marks. (Consult the reference for the particular database and connector you are using for more details.)

Interroger les champs Oui/Non

Pour lancer une requête sur des champs Oui/Non, utilisez la syntaxe suivante pour des tables dBase :

État

Critères de requête

Exemple

Oui

pour les tables dBASE : différente d'une quelconque valeur donnée

=1 renvoie tous les enregistrements pour lesquels le champ Oui/Non est de statut "Oui" ou "activé" (sélectionné en noir),

Non

.

=0 renvoie tous les enregistrements pour lesquels le champ Oui/Non a l'état "Non" ou "désactivé" (aucune sélection).

Null

EST NUL

IS NULL renvoie tous les enregistrements pour lesquels le champ Oui/Non n'a ni l'état Oui ni l'état Non (sélectionné en gris).


Icône Remarque

La syntaxe dépend du système de base de données utilisé. Remarquez également que les champs Oui/Non peuvent être définis différemment (deux statuts seulement au lieu de trois).


Requêtes avec paramètre

Les requêtes paramétrées permettent à l'utilisateur de fournir des valeurs à l'exécution. Ces valeurs sont utilisées dans les critères pour sélectionner les enregistrement à afficher. Chacune de ces valeurs est associée à un nom de paramètre qui est utilisé pour demander à l'utilisateur de fournir cette valeur lorsque la requête est exécutée.

Les noms de paramètre sont précédés par un deux-points dans les deux modes Ébauche et SQL d'une requête. Ils peuvent être utilisés partout où une valeur peut apparaître. Si la même valeur doit apparaître plus d'une fois dans une requête, le même nom de paramètre sera utilisé.

Dans le cas le plus simple où l'utilisateur saisit une valeur pour une relation d'égalité, le nom de paramètre précédé de son deux-points est simplement saisi dans la ligne du critère. En mode SQL cela devrait être saisi sous la forme WHERE "Field" = :Parameter_name

Icône Avertissement

Les noms de paramètre ne peuvent contenir aucun des caractères <space>`!"$%^*()+={}[]@'~#<>?/,. Ils ne peuvent pas être identiques à des noms de champs ni à des mots SQL réservés. Ils peuvent être identiques à des alias.


Icône Astuce

Une construction utile pour sélectionner des enregistrements sur la base de parties du contenu d'un champ texte, est d'ajouter une colonne masquée avec "LIKE '%' || :Part_of_field || '%'" comme critère. Cela sélectionnera les enregistrements avec une correspondance exacte. Si l'on veut un test insensible à la casse, une solution est d'utiliser LOWER (Field_Name) comme champ et LIKE LOWER ( '%' || :Part_of_field || '%' ) comme critère. Notez que les espaces dans le critère sont importants ; s'ils sont absents l'analyseur syntaxique SQL interprète le critère entier comme une chaîne de caractères à mettre en correspondance. En mode SQL cela devrait être saisi sous la forme LOWER ( "Field_Name" ) LIKE LOWER ( '%' || :Part_of_field || '%' ).


Les requêtes de paramètre peuvent être utilisées comme source de donnée pour sous-formulaire afin de permettre à l'utilisateur de limiter les enregistrements affichés.

Saisie de paramètre

La boîte de dialogue Saisie de paramètre demande à l'utilisateur d'indiquer les valeurs des paramètres. Saisissez une valeur pour chaque paramètre de requête et confirmez en cliquant sur OK ou en appuyant sur Entrée.

Pour la saisie des valeurs l'utilisateur peut utiliser n'importe quel caractère autorisé pour le SQL pour le critère correspondant ; cela peut dépendre du système de base de données sous-jacent.

Icône Astuce

L'utilisateur peut utiliser les caractères de substitution SQL "%" (chaîne de caractères arbitraire) ou "_" (caractère arbitraire) comme partie de la valeur pour extraire des enregistrements avec des critères plus complexes.


Mode SQL

L'abréviation SQL signifie "Structured Query Language" (langage de requête structuré) et désigne un ensemble d'instructions destinées à interroger, actualiser et gérer des bases de données relationnelles.

In LibreOfficeDev you do not need any knowledge of SQL for most queries, since you do not have to enter the SQL code. If you create a query in the query designer, LibreOfficeDev automatically converts your instructions into the corresponding SQL syntax. If, with the help of the Switch Design View On/Off button, you change to the SQL view, you can see the SQL commands for a query that has already been created.

You can formulate your query directly in SQL code. Note, however, that the special syntax is dependent upon the database system that you use.

If you enter the SQL code manually, you can create SQL-specific queries that are not supported by the graphical interface in the Query designer. These queries must be executed in native SQL mode.

By clicking the Run SQL command directly icon in the SQL view, you can formulate a query that is not processed by LibreOfficeDevand sent directly to the database engine.