Use tidb as metastore

config/hive-site.xml

@@ -0,0 +1,43 @@
+<?xml version="1.0"?>
+<?xml-stylesheet type="text/xsl" href="configuration.xsl"?>
+<!--
+   Licensed to the Apache Software Foundation (ASF) under one or more
+   contributor license agreements.  See the NOTICE file distributed with
+   this work for additional information regarding copyright ownership.
+   The ASF licenses this file to You under the Apache License, Version 2.0
+   (the "License"); you may not use this file except in compliance with
+   the License.  You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
+-->
+
+<configuration>
+<property>
+  <name>javax.jdo.option.ConnectionURL</name>
+  <value>jdbc:mysql://localhost:4000/metastore_db?createDatabaseIfNotExist=true&amp;useSSL=false&amp;autoReconnect=true</value>
+  <description>JDBC connect string for a JDBC metastore</description>
+</property>
+
+<property>
+  <name>javax.jdo.option.ConnectionDriverName</name>
+  <value>com.mysql.jdbc.Driver</value>
+  <description>Driver class name for a JDBC metastore</description>
+</property>
+
+<property>
+  <name>javax.jdo.option.ConnectionUserName</name>
+  <value>hive</value>
+  <description>username to use against metastore database</description>
+</property>
+
+<property>
+  <name>javax.jdo.option.ConnectionPassword</name>
+  <value>mine</value>
+</property>
+</configuration>

docs/how_to_use_tidb_as_metastore_db.md

@@ -0,0 +1,27 @@
+# Setting TiDB as metastore db
+
+Generally sparking, you need setup tidb first and then copy `hive-site.xml` into Spark's `conf`
+directory.
+
+## Setup TiDB
+
+First you need have a TiDB cluster present, and then use a mysql client log into TiDB cluster. 
+
+You will need execute the following command:
+
+```$xslt
+CREATE USER 'hive'@'%' IDENTIFIED BY 'mine';
+GRANT ALL PRIVILEGES ON metastore.* TO 'hive'@'%';
+FLUSH PRIVILEGES;
+```
+
+It helps you create a user and grant access privileges to all databases and tables. 
+
+## Adding hive-site.xml configuration to Spark
+
+Then you can find a sample conf file at config directory at [tispark](https://github.com/pingcap/tispark)
+project. What you need to do is copy and paste such file into `SPARK_HOME/conf`. One last thing to mention 
+is that you need to adjust some properties if you change the user name or user password at 
+setting up tidb step. 
+
+After you finish these two steps, you are able to use tidb to store meta info of Spark.