Skip to content
This repository was archived by the owner on May 5, 2019. It is now read-only.

Latest commit

 

History

History
74 lines (57 loc) · 3.28 KB

joins.md

File metadata and controls

74 lines (57 loc) · 3.28 KB

Database-Style Joins

We often need to combine two or more data sets together to provide a complete picture of the topic we are studying. For example, suppose that we have the following two data sets:

names = DataTable(ID = [1, 2], Name = ["John Doe", "Jane Doe"])
jobs = DataTable(ID = [1, 2], Job = ["Lawyer", "Doctor"])

We might want to work with a larger data set that contains both the names and jobs for each ID. We can do this using the join function:

full = join(names, jobs, on = :ID)

Output:

Row ID Name Job
1 1 "John Doe" "Lawyer"
2 1 "Jane Doe" "Doctor"

In relational database theory, this operation is generally referred to as a join. The columns used to determine which rows should be combined during a join are called keys.

There are seven kinds of joins supported by the DataTables package:

  • Inner: The output contains rows for values of the key that exist in both the first (left) and second (right) arguments to join.
  • Left: The output contains rows for values of the key that exist in the first (left) argument to join, whether or not that value exists in the second (right) argument.
  • Right: The output contains rows for values of the key that exist in the second (right) argument to join, whether or not that value exists in the first (left) argument.
  • Outer: The output contains rows for values of the key that exist in the first (left) or second (right) argument to join.
  • Semi: Like an inner join, but output is restricted to columns from the first (left) argument to join.
  • Anti: The output contains rows for values of the key that exist in the first (left) but not the second (right) argument to join. As with semi joins, output is restricted to columns from the first (left) argument.
  • Cross: The output is the cartesian product of rows from the first (left) and second (right) arguments to join.

You can control the kind of join that join performs using the kind keyword argument:

a = DataTable(ID = [1, 2], Name = ["A", "B"])
b = DataTable(ID = [1, 3], Job = ["Doctor", "Lawyer"])
join(a, b, on = :ID, kind = :inner)
join(a, b, on = :ID, kind = :left)
join(a, b, on = :ID, kind = :right)
join(a, b, on = :ID, kind = :outer)
join(a, b, on = :ID, kind = :semi)
join(a, b, on = :ID, kind = :anti)

Cross joins are the only kind of join that does not use a key:

join(a, b, kind = :cross)

In order to join data tables on keys which have different names, you must first rename them so that they match. This can be done using rename!:

a = DataTable(ID = [1, 2], Name = ["A", "B"])
b = DataTable(IDNew = [1, 2], Job = ["Doctor", "Lawyer"])
rename!(b, :IDNew, :ID)
join(a, b, on = :ID, kind = :inner)

Or renaming multiple columns at a time:

a = DataTable(City = ["Amsterdam", "London", "London", "New York", "New York"],
              Job = ["Lawyer", "Lawyer", "Lawyer", "Doctor", "Doctor"],
              Category = [1, 2, 3, 4, 5])
b = DataTable(Location = ["Amsterdam", "London", "London", "New York", "New York"],
              Work = ["Lawyer", "Lawyer", "Lawyer", "Doctor", "Doctor"],
              Name = ["a", "b", "c", "d", "e"])
rename!(b, [:Location => :City, :Work => :Job])
join(a, b, on = [:City, :Job])