You are browsing a read-only backup copy of Wikitech. The primary site can be found at

Analytics/Cluster/Hive: Difference between revisions

From Wikitech-static
Jump to navigation Jump to search
No edit summary
(Milimetric moved page Analytics/Cluster/Hive to Analytics/Systems/Cluster/Hive: Reorganizing documentation)
(9 intermediate revisions by 6 users not shown)
Line 1: Line 1:
[[File:Pageview_@_Wikimedia_(WMF_Analytics_lightning_talk,_June_2015).pdf|thumb|350px|page=6|Hive/Hadoop (rounded box at the bottom) within the Wikimedia Foundation's pageview data pipeline]]
#REDIRECT [[Analytics/Systems/Cluster/Hive]]
[ Apache Hive] is an abstraction built on top of MapReduce that allows SQL to be used on various file formats stored in [[:en:Apache_Hadoop#HDFS|HDFS]].  WMF's first use case was to enable querying of unsampled webrequest logs.
== Maintained Tables ==
''(see also [[Analytics/Data]])''
* [[Analytics/Data/Webrequest|Webrequest]] (raw and refined)
* [[Analytics/Data/Pageview hourly|pageview_hourly]]
* [[Analytics/Data/Projectview hourly|projectview_hourly]]
* [[Analytics/Data/Pagecounts-all-sites|pagecounts_all_sites]]
* [[Analytics/Data/Mediacounts|mediacounts]]
* ...
== Querying ==
To access data, use
Inside Hive CLI, you can query the [[Analytics/Data/Webrequest|wmf.webrequest]] and other tables:
<source lang="SQL" enclose="div">
-- Calculate per-country mobile page views for 2015-04-10 00:00--01:00 (1st hour)
    geocoded_data['country_code'] country, COUNT(*) cc_count
FROM wmf.webrequest
    webrequest_source = 'mobile'  -- could be 'text', 'upload', 'bits', 'misc', ...
    AND year = 2015             
    AND month = 4
    AND day = 10
    AND hour = 0
    AND is_pageview
Notice the <tt>webrequest_source</tt>, <tt>year</tt>, <tt>month</tt>, <tt>day</tt>, and <tt>hour</tt> fields.  These are Hive [ partitions], and are explicit mappings to hourly imports in HDFS.  You must include at least one partition predicate in the <tt>where</tt> clause of your queries (even if it is just <tt>year > 0</tt>).  Partitions allow you to reduce the amount of data that Hive must parse and process before it returns you results.  For example, if are only interested in data during a particular day, you could add <tt>where year = 2014 and month = 1 and day = 12</tt>.  This will instruct Hive to only process data for partitions that match that partition predicate.  You may use partition fields as you would any normal field, even though the field values are not actually stored in the data files.
Most SQL is supported by Hive, with a few differences.  See the [ Hive Language Manual] for more info.
=== Notes ===
* The wmf_raw and wmf databases contain Hive tables maintained by Ops.  You can create your own tables in Hive, but please be sure to create them in a different database, preferably one named after your shell username.''
* Hive has the ability to map tables on top of almost any data structure.  Since webrequest logs are JSON, the Hive tables must be told to use a JSON [ SerDe] to be able to serialize/deserialize to/from JSON.  We use the JsonSerDe included with [ Hive-HCatalog].
* The HCatalog .jar will be automatically added to a Hive client's auxpath.  You shouldn't need to think about it.
== Sample Queries ==
* [[Analytics/Cluster/Hive/Queries]] (includes a FAQ about common tasks and problems)
* [[Analytics/Cluster/Hive/QueryUsingUDF]]
== Killing a running query ==
Once you submit a query, it is handed off to Hadoop.  Hadoop runs the query as a YARN application.  The Hive CLI is then detached from the actual application.  If you Ctrl-C your Hive CLI, you will quit the interface you used to submit the query, but will not actually kill the application.  To kill the application, you have to tell YARN you want it dead.
Note the application ID from when your query started.  You should see something like:
  Starting Job = job_1387838787660_12241, Tracking URL = http://analytics1010.eqiad.wmnet:8088/proxy/application_1387838787660_12241/
The application ID in this case is  application_1387838787660_12241.  To kill this application, run:
  yarn application -kill application_1387838787660_12241
== Troubleshooting ==
== See also ==
* [[Analytics/Cluster/Access]] - on how to access Hive and Hue (Hadoop User Experience, a GUI for Hive)
== References ==
* [[Analytics/Cluster/Hive/Queries|WMF Researcher Hive Queries Examples]]
* [[mediawikiwiki:Analytics/Kraken/Researcher_analysis|Early Hive at WMF Researcher Analysis]] (2013)
* [[Analytics/Cluster/Hive/Compression|Hive Compression Test]]
* [ Hadoop SequenceFile]
* [ Introduction to Hive Partitioning]

Latest revision as of 13:44, 7 April 2017