Browse Source

mview guide

bradford.condon 6 years ago
parent
commit
f2748ccded

BIN
docs/user_guide/mviews.1.png


+ 17 - 1
docs/user_guide/mviews.rst

@@ -1,4 +1,20 @@
 Materialized Views
 ==================
 
-Lorem ipsum
+Chado is efficient as a data warehouse but queries can become slow depending on the type of query. To help simplify and speed up these queries, materialized views can be employed. For a materialized view, a new database table is created and then populated with the results of a pre-defined SQL query. This allows you to execute a much simpler and faster query on the materialized view when producing user pages. A side effect, however is redundant data, with the materialized view becoming stale if not updated regularly.
+
+Tripal provides a mechanism for populating and updating these materialized views. These can be found on the ``Tripal → Data Storage → Chado -> Materialized Views`` page.
+
+.. image:: ./mviews.1.png
+
+Here we see several materialized views. These were installed automatically by the Tripal Chado module. To update these views, click the **Populate** link for each one.
+
+This will submit jobs to populate the views with data. Now, run the jobs:
+
+.. code-block:: shell
+
+  cd /var/www/html
+  drush trp-run-jobs --user=administrator
+
+
+You can now see that all views are up-to-date on the **Materialized Views Page**. The number of rows in the view table is shown.

+ 1 - 1
docs/user_guide/searching/elasticsearch_module.rst

@@ -1,5 +1,5 @@
 Tripal Elasticsearch Module
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+========================================
 
 
 Tripal Elasticsearch is a module that integrates the `Elasticsearch <https://www.elastic.co/products/elasticsearch>`_ search engine with Tripal sites. By enabling the module, you are provided with a set of tools to index and search your Tripal 3 or Tripal 2 site. It provides an easy to set up site wide search and gene search blocks out of the box. Tripal Elasticsearch also provides support for Cross-site querying, which allows users to search multiple websites in a fast and asynchronous manner in one query.