Skip to content

Latest commit

 

History

History
167 lines (82 loc) · 7.28 KB

faq-updates-errata.md

File metadata and controls

167 lines (82 loc) · 7.28 KB

Practical SQL: A Beginner's Guide to Storytelling with Data, 2nd Edition

FAQ, Updates, and Errata

This page contains answers to Frequently Asked Questions, updates to material and URLs, and errata for Practical SQL, 2nd Edition. Some of these apply to the first couple of printings of the book and may be updated if you have a third printing or later. Check the copyright page to see which printing you have.

Introduction

  • No updates

Chapter 1: Setting Up Your Coding Environment

  • Page 3: Downloading Code and Data from GitHub

The GitHub folder name has been renamed to practical-sql-2-main from practical-sql-2-master in line with GitHub conventions. (Applies only to first printing of the book.)

  • Page 5: Windows Installation (PostGIS)

The PostGIS installer for Windows now asks you to check off which components to install rather than providing individual Yes/No prompts. You can select all components including Create Spatial Database. (Applies to printings one through three of the book.)

The Windows 11 Start menu continues to evolve. To see the PostgreSQL and PostGIS folders added during installation, you may need to click Start > All apps.

  • Pages 6 and 7: Configuring Python language support (Windows)

Note that the current version of the EDB Language Pack is updated from the version shown in the book. Use the folder and version name provided via the EDB Windows installer for PATH and PYTHONHOME. Since October 2023, that path is C:\edb\languagepack\v4\Python-3.11

  • Pages 12 and on: pgAdmin Renamed "Browser" to "Object Explorer"

In Figure 1-3 on page 12, and in text on that page and subsequent references, the book refers to a section of pgAdmin labeled as the "Browser" or "object browser." As of pgAdmin 4 v7.0, the user interface has changed to call that area the "Object Explorer." (Applies to first and second printings.)

  • Page 13: pgAdmin Dialog to Create Server

The location of the pgAdmin dialog to add a server has changed. Now, in the object browser, right-click Servers and then click Register > Server. The remaining steps in the Note on page 13 are the same. (Formerly, the dialog was accessed by right-clicking Servers and selecting Create > Server.) (Applies only to first printing of the book.)

  • Page 14: pgAdmin: Running a Query

pgAdmin, as of version 8.7 (May 2024), has added new options for running a SQL statement in the Query Tool. Previously, the Query Tool had a single Execute/Refresh button in its menu bar. That has been replaced by two buttons: Execute Script and Execute Query.

Clicking Execute Script will run every statement in your Query Tool editor (unless you highlight a statement). Clicking Execute Query will run only the statement where your cursor is positioned, without a need to highlight the statement. It also will present you with a dialog box to confirm your choice (which you can choose to silence in the future). Applies to printings one through three of the book.

  • Page 15, Figure 1-5: pgAdmin Query Tool

Version 6.9 of pgAdmin, released in May 2022, introduced a redesigned Query Tool Layout. General functionality is the same, but if you are using version 6.9 or later, you will see that some menu icons shown in the book at the top of the window are now placed atop the results grid. (Applies only to first printing of the book.)

  • Page 15, Customizing pgAdmin

The book states that pgAdmin preferences are accessed by clicking File > Preferences. This is true for Windows 11. On macOS, click pgAdmin > Preferences.

Chapter 2: Creating Your First Database and Table

  • No updates

Chapter 3: Beginning Data Exploration with SELECT

  • No updates

Chapter 4: Understanding Data Types

  • No updates

Chapter 5: Importing and Exporting Data

  • Page 65, Understanding Census Columns and Data Types

The URL for the 2010 Census technical documentation has been moved to https://www2.census.gov/programs-surveys/decennial/rdo/about/2010-census-programs/2010Census_pl94-171_techdoc.pdf

Chapter 6: Basic Math and Stats with SQL

  • No updates

Chapter 7: Joining Tables in a Relational Database

  • No updates

Chapter 8: Table Design That Works for You

  • No updates

Chapter 9: Extracting Information by Grouping and Summarizing

  • No updates

Chapter 10: Inspecting and Modifying Data

  • Page 180: Improving Performance When Updating Large Tables

The second statement in Listing 10-26 renames the copy we made with Listing 10-25 to the original name of the table. The text incorrectly says we are renaming the copy made in Listing 10-24.

Chapter 11: Statistical Functions in SQL

  • No updates

Chapter 12: Working With Dates and Times

  • Page 214: Finding Patterns in New York City Taxi Data

The URL for the NYC tax trip data dictionary has moved to https://www.nyc.gov/assets/tlc/downloads/pdf/data_dictionary_trip_records_yellow.pdf

Chapter 13: Advanced Query Techniques

  • Page 240: Listing number

At the bottom of the page, the sentence should read, "The crosstab structure is the same as in Listing 13-17." (Applies to first and second printings.)

Chapter 14: Mining Text to Find Meaningful Data

  • Pages 253, etc.: Turning Text to Data with Regular Expression Functions

The dates of crimes in this section are in the format MM/DD/YY. If your database has a datestyle setting other than MDY -- for example if you're in Europe -- then you will likely need to set your datestyle to complete the examples.

Check your datestyle by running this query in pgAdmin:

SHOW datestyle;

If the result is other than ISO, MDY, you can set the datestyle on a per-session basis by running this command:

SET datestyle to "ISO, MDY";

You can then complete the examples. The change will persist until you restart pgAdmin.

  • Page 267: Creating a Table for Full-Text Search

The COPY statement in Listing 14-18 uses an at-sign (@) for quoting, not an ampersand.

Chapter 15: Analyzing Spatial Data with PostGIS

  • Pages 280: URL for WKT variable definitions

Documentation for the definition of WKT variables has moved to https://docs.geotools.org/stable/javadocs/org/geotools/api/referencing/doc-files/WKT.html

  • Pages 282, etc.: Geometry Viewer Results Grid Icon

Beginning with version 6.9 of pgAdmin, released in May 2022, the icon to launch the Geometry Viewer in the result column header was changed from an eye to a map (makes sense). On Page 282 and later in the book, I mention clicking the eye icon to launch the viewer. Now, instead, click the map icon. (Applies to first printing of the book.)

Chapter 16: Working With JSON Data

  • No updates

Chapter 17: Saving Time with Views, Functions, and Triggers

  • No updates

Chapter 18: Using PostgreSQL from the Command Line

  • No updates

Chapter 19: Maintaining Your Database

  • No updates

Index

  • Page 417: IN comparison operator

The entry should reference pages 36, 172, 229. (Applies to first printing of the book.)