SWAMPy

✎ CARVE FLESH

EDITING: bookmarks.txt

.. _bookmarks:

Bookmarks
=========

.. note::

You need to have configured the :ref:`linked-tables` for using bookmarks
    feature.

Storing bookmarks
-----------------

Any query you have executed can be stored as a bookmark on the page
where the results are displayed. You will find a button labeled
:guilabel:`Bookmark this query` just at the end of the page. As soon as you have
stored a bookmark, it is related to the database you run the query on.
You can now access a bookmark dropdown on each page, the query box
appears on for that database.

Variables inside bookmarks
--------------------------

You can also have, inside the query, placeholders for variables.
This is done by inserting into the query SQL comments between ``/*`` and
``*/``. Inside the comments, the special strings ``[VARIABLE{variable-number}]`` is used.
Be aware that the whole query minus the SQL comments must be
valid by itself, otherwise you won't be able to store it as a bookmark.
Note also that the text 'VARIABLE' is case-sensitive.

When you execute the bookmark, everything typed into the *Variables*
input boxes on the query box page will replace the strings ``/*[VARIABLE{variable-number}]*/`` in
your stored query.

Also remember, that everything else inside the ``/*[VARIABLE{variable-number}]*/`` string for
your query will remain the way it is, but will be stripped of the ``/**/``
chars. So you can use:

.. code-block:: mysql

/*, [VARIABLE1] AS myname */

which will be expanded to

.. code-block:: mysql

, VARIABLE1 as myname

in your query, where VARIABLE1 is the string you entered in the Variable 1 input box.

A more complex example. Say you have stored
this query:

.. code-block:: mysql

SELECT Name, Address FROM addresses WHERE 1 /* AND Name LIKE '%[VARIABLE1]%' */

Say, you now enter "phpMyAdmin" as the variable for the stored query, the full
query will be:

.. code-block:: mysql

SELECT Name, Address FROM addresses WHERE 1 AND Name LIKE '%phpMyAdmin%'

**NOTE THE ABSENCE OF SPACES** inside the ``/**/`` construct. Any spaces
inserted there will be later also inserted as spaces in your query and may lead
to unexpected results especially when using the variable expansion inside of a
"LIKE ''" expression.

Browsing a table using a bookmark
---------------------------------

When a bookmark has the same name as the table, it will be used as the query when browsing
this table.

.. seealso::

:ref:`faqbookmark`,
    :ref:`faq6_22`

CANCEL

Name	Type	Size	Modified	Actions
↩ ..	DIR	—	—
📄 bookmarks.txt	TXT	2.4 KB	2019-06-04 12:06	EDIT
📄 charts.txt	TXT	4.6 KB	2019-06-04 12:06	EDIT
📄 config.txt	TXT	112.6 KB	2019-06-04 12:06	EDIT
📄 copyright.txt	TXT	1.6 KB	2019-06-04 12:06	EDIT
📄 credits.txt	TXT	26.4 KB	2019-06-04 12:06	EDIT
📄 developers.txt	TXT	380 B	2019-06-04 12:06	EDIT
📄 faq.txt	TXT	91.1 KB	2019-06-04 12:06	EDIT
📄 glossary.txt	TXT	13.4 KB	2019-06-04 12:06	EDIT
📄 import_export.txt	TXT	10.1 KB	2019-06-04 12:06	EDIT
📄 index.txt	TXT	573 B	2019-06-04 12:06	EDIT
📄 intro.txt	TXT	3.1 KB	2019-06-04 12:06	EDIT
📄 other.txt	TXT	916 B	2019-06-04 12:06	EDIT
📄 privileges.txt	TXT	3.2 KB	2019-06-04 12:06	EDIT
📄 relations.txt	TXT	3.3 KB	2019-06-04 12:06	EDIT
📄 require.txt	TXT	1.7 KB	2019-06-04 12:06	EDIT
📄 security.txt	TXT	4.5 KB	2019-06-04 12:06	EDIT
📄 settings.txt	TXT	1015 B	2019-06-04 12:06	EDIT
📄 setup.txt	TXT	40.3 KB	2019-06-04 12:06	EDIT
📄 themes.txt	TXT	2.9 KB	2019-06-04 12:06	EDIT
📄 transformations.txt	TXT	6.5 KB	2019-06-04 12:06	EDIT
📄 two_factor.txt	TXT	2.8 KB	2019-06-04 12:06	EDIT
📄 user.txt	TXT	195 B	2019-06-04 12:06	EDIT
📄 vendors.txt	TXT	1.1 KB	2019-06-04 12:06	EDIT