.. only:: html
|LS| Adding Data to the Model
===============================================================================
The models we've created will now need to be populated with the data they're
intended to contain.
**The goal for this lesson:** To learn how to insert new data into the database
models.
Insert statement
-------------------------------------------------------------------------------
How do you add data to a table? The sql :kbd:`INSERT` statement provides the
functionality for this:
.. code-block:: sql
insert into streets (name) values ('High street');
A couple of things to note:
* After the table name (:kbd:`streets`), you list the column names that you
will be populating (in this case only the :kbd:`name` column).
* After the :kbd:`values` keyword, place the list of field values.
* Strings should be quoted using single quotes.
* Note that we did not insert a value for the :kbd:`id` column; this
is because it is a sequence and will be auto-generated.
* If you do manually set the :kbd:`id`, you may cause serious problems with
the integrity of your database.
You should see :kbd:`INSERT 0 1` if it is successful.
You can see the result of your insert action by selecting all the data in the
table:
.. code-block:: sql
select * from streets;
Result:
.. code-block:: sql
select * from streets;
id | name
----+-------------
1 | High street
(1 row)
|TY| |basic|
...............................................................................
Use the :kbd:`INSERT` command to add a new street to the :kbd:`streets` table.
:ref:`Check your results `
.. _backlink-database-concepts-6:
Sequencing Data Addition According to Constraints
-------------------------------------------------------------------------------
|TY| |moderate|
-------------------------------------------------------------------------------
Try to add a person object to the :kbd:`people` table with the following details::
Name: Joe Smith
House Number: 55
Street: Main Street
Phone: 072 882 33 21
.. note:: Recall that in this example, we defined phone numbers as strings, not
integers.
At this point, you should have an error report if you try to do this without
first creating a record for Main Street in the :kbd:`streets` table.
You should have also noticed that:
* You can't add the street using its name
* You can't add a street using a street :kbd:`id` before first creating the
street record on the streets table
Remember that our two tables are linked via a Primary/Foreign Key pair. This
means that no valid person can be created without there also being a valid
corresponding street record.
Using the above knowledge, add the new person to the database.
:ref:`Check your results `
.. _backlink-database-concepts-7:
Select data
-------------------------------------------------------------------------------
We have already shown you the syntax for selecting records. Let's look at a few
more examples:
.. code-block:: sql
select name from streets;
.. code-block:: sql
select * from streets;
.. code-block:: sql
select * from streets where name='Main Road';
In later sessions we will go into more detail on how to select and filter data.
Update data
-------------------------------------------------------------------------------
What if you want to make a change to some existing data? For example, a street
name is changed:
.. code-block:: sql
update streets set name='New Main Road' where name='Main Road';
Be very careful using such update statements - if more than one record matches
your :kbd:`WHERE` clause, they will all be updated!
A better solution is to use the primary key of the table to reference the
record to be changed:
.. code-block:: sql
update streets set name='New Main Road' where id=2;
It should return :kbd:`UPDATE 1`.
.. note:: the :kbd:`WHERE` statement criteria are case sensitive :kbd:`Main
Road` is not the same as :kbd:`Main road`
Delete Data
-------------------------------------------------------------------------------
In order to delete an object from a table, use the :kbd:`DELETE` command:
.. code-block:: sql
delete from people where name = 'Joe Smith';
Let's look at our people table now:
.. code-block:: sql
address=# select * from people;
id | name | house_no | street_id | phone_no
----+------+----------+-----------+----------
(0 rows)
|TY| |hard|
-------------------------------------------------------------------------------
Use the skills you have learned to add some new friends to your database:
.. code-block:: sql
name | house_no | street_id | phone_no
-----------------+----------+-----------+--------------
Joe Bloggs | 3 | 2 | 072 887 23 45
Jane Smith | 55 | 3 | 072 837 33 35
Roger Jones | 33 | 1 | 072 832 31 38
Sally Norman | 83 | 1 | 072 932 31 32
|IC|
-------------------------------------------------------------------------------
Now you know how to add new data to the existing models you created previously.
Remember that if you want to add new kinds of data, you may want to modify
and/or create new models to contain that data.
|WN|
-------------------------------------------------------------------------------
Now that you've added some data, you'll learn how to use queries to access this
data in various ways.
.. Substitutions definitions - AVOID EDITING PAST THIS LINE
This will be automatically updated by the find_set_subst.py script.
If you need to create a new substitution manually,
please add it also to the substitutions.txt file in the
source folder.
.. |IC| replace:: In Conclusion
.. |LS| replace:: Lesson:
.. |TY| replace:: Try Yourself
.. |WN| replace:: What's Next?
.. |basic| image:: /static/global/basic.png
.. |hard| image:: /static/global/hard.png
.. |moderate| image:: /static/global/moderate.png