Merge pull request #2 from Percona-Lab/indexes

Added support for Foreign Keys constraints

Author: percona-csalguero

Gopkg.lock

@@ -0,0 +1,42 @@
+
+# Gopkg.toml example
+#
+# Refer to https://github.com/golang/dep/blob/master/docs/Gopkg.toml.md
+# for detailed Gopkg.toml documentation.
+#
+# required = ["github.com/user/thing/cmd/thing"]
+# ignored = ["github.com/user/project/pkgX", "bitbucket.org/user/project/pkgA/pkgY"]
+#
+# [[constraint]]
+#   name = "github.com/user/project"
+#   version = "1.0.0"
+#
+# [[constraint]]
+#   name = "github.com/user/project2"
+#   branch = "dev"
+#   source = "github.com/myfork/project2"
+#
+# [[override]]
+#  name = "github.com/x/y"
+#  version = "2.4.0"
+
+
+[[constraint]]
+  name = "github.com/go-sql-driver/mysql"
+  version = "1.3.0"
+
+[[constraint]]
+  branch = "master"
+  name = "github.com/gosuri/uiprogress"
+
+[[constraint]]
+  branch = "master"
+  name = "github.com/icrowley/fake"
+
+[[constraint]]
+  branch = "master"
+  name = "github.com/kr/pretty"
+
+[[constraint]]
+  name = "gopkg.in/alecthomas/kingpin.v2"
+  version = "2.2.5"

Gopkg.toml

@@ -50,12 +50,32 @@ The program can detect if a field accepts NULLs and if it does, it will generate
 ## Options
 |Option|Description|
 |------|-----------|
+|--bulk-size|Number of rows per INSERT statement (Default: 1000)|
+|--debug|Show some debug information|
+|--fk-samples-factor|Percentage used to get random samples for foreign keys fields. Default 0.3|
 |--host|Host name/ip|
+|--max-fk-samples|Maximum number of samples for fields having foreign keys constarints. Default: 100|
+|--max-retries|Maximum number of rows to retry in case of errors. See duplicated keys. Deafult: 100|
+|--password|Password|
 |--port|Port number|
+|--show-progressbar|Show the progress bar. Default: true|
 |--user|Username|
-|--password|Password|
-|--bulk-size|Number of rows per INSERT statement (Default: 1000)|
-|--debug|Show some debug information|
+
+## Foreign keys support
+If a field has Foreign Keys constraints, `random-data-load` will get up to `--max-fk-samples` random samples from the referenced tables in order to insert valid values for the field.  
+The number of samples to get follows this rules:  
+**1.** Get the aproximate number of rows in the referenced table using the `rows` field in:  
+```
+EXPLAIN COUNT(*) FROM <referenced schema>.<referenced table>
+```
+**1.1** If the number of rows is less than `max-fk-samples`, all rows are retrieved from the referenced table using this query: 
+```
+SELECT <referenced field> FROM <referenced schema>.<referenced table>
+```
+**1.2** If the number of rows is greater than `max-fk-samples`, samples are retrieved from the referenced table using this query:  
+```
+SELECT <referenced field> FROM <referenced schema>.<referenced table> WHERE RAND() <= <fk-samples-factor> LIMIT <max-fk-samples>
+```
 
 ### Example
 ```
@@ -135,6 +155,19 @@ tcol28: 6.12
 
 ## To do
 - [ ] Add suport for all data types.
-- [ ] Add supporrt for foreign keys.
+- [X] Add supporrt for foreign keys.
 - [ ] Support config files to override default values/ranges.
 - [ ] Support custom functions via LUA plugins.
+
+## Versions history
+
+#### 0.1.2
+- New table parser able to retrieve all the information for fields, indexes and foreign keys constraints.
+- Support for foreign keys constraints
+- Added some tests
+
+#### 0.1.1
+- Fixed random data generation
+
+#### 0.1.0
+- Initial version