Foreign data wrappers concept in PostgreSQL - Mini Project: Build & Apply

Using Foreign Data Wrappers in PostgreSQL

📖 Scenario: You work in a company that uses PostgreSQL as its main database. You want to access data from another PostgreSQL database without copying the data. Foreign Data Wrappers (FDW) let you do this by connecting to the other database and querying its tables as if they were local.

🎯 Goal: Learn how to set up a Foreign Data Wrapper in PostgreSQL to access a table from a remote database.

📋 What You'll Learn

Create a foreign server connection to a remote PostgreSQL database

Create a user mapping for authentication

Create a foreign table that links to a remote table

Query the foreign table to access remote data

💡 Why This Matters

🌍 Real World

Companies often need to access data stored in different databases without copying it. Foreign Data Wrappers let you query remote data as if it were local, saving time and storage.

💼 Career

Database administrators and backend developers use FDWs to integrate multiple data sources, enabling efficient data analysis and reporting.

1

Create the Foreign Server

Write a SQL command to create a foreign server called remotedb that connects to a PostgreSQL database on host '192.168.1.100' at port 5432 with database name 'sales'. Use the postgres_fdw foreign data wrapper.

PostgreSQL

-- Your code here to create the foreign server

Hint

Use CREATE SERVER with FOREIGN DATA WRAPPER postgres_fdw and specify host, port, and dbname in OPTIONS.

2

Create User Mapping for Authentication

Write a SQL command to create a user mapping for the current user to connect to the remotedb server. Use username 'remote_user' and password 'secret123'.

PostgreSQL

CREATE SERVER remotedb FOREIGN DATA WRAPPER postgres_fdw OPTIONS (host '192.168.1.100', port '5432', dbname 'sales');
-- Your code here to create user mapping

Hint

Use CREATE USER MAPPING FOR CURRENT_USER SERVER remotedb and specify user and password in OPTIONS.

3

Create the Foreign Table

Write a SQL command to create a foreign table called remote_customers that links to the customers table on the remotedb server. The table has columns id (integer) and name (text).

PostgreSQL

CREATE SERVER remotedb FOREIGN DATA WRAPPER postgres_fdw OPTIONS (host '192.168.1.100', port '5432', dbname 'sales');
CREATE USER MAPPING FOR CURRENT_USER SERVER remotedb OPTIONS (user 'remote_user', password 'secret123');
-- Your code here to create foreign table

Hint

Use CREATE FOREIGN TABLE with columns and link it to SERVER remotedb. Specify schema_name and table_name in OPTIONS.

4

Query the Foreign Table

Write a SQL query to select all columns from the foreign table remote_customers.

PostgreSQL

CREATE SERVER remotedb FOREIGN DATA WRAPPER postgres_fdw OPTIONS (host '192.168.1.100', port '5432', dbname 'sales');
CREATE USER MAPPING FOR CURRENT_USER SERVER remotedb OPTIONS (user 'remote_user', password 'secret123');
CREATE FOREIGN TABLE remote_customers (id integer, name text) SERVER remotedb OPTIONS (schema_name 'public', table_name 'customers');
-- Your code here to query the foreign table

Hint

Use a simple SELECT * FROM remote_customers; to get all data from the foreign table.

Practice

1. What is the main purpose of a Foreign Data Wrapper (FDW) in PostgreSQL?

easy

A. To speed up local query execution by caching results

B. To create backup copies of local tables automatically

C. To encrypt data stored in PostgreSQL tables

D. To access external data sources as if they were local tables

Solution

1. Step 1: Understand FDW functionality

   FDWs allow PostgreSQL to connect to external data sources and treat them like local tables.

2. Step 2: Compare options

   Options A, B, and D describe unrelated features: caching, backups, and encryption, not FDWs.

3. Final Answer:

   To access external data sources as if they were local tables -> Option D

4. Quick Check:

   FDW = Access external data like local tables [OK]

Hint: FDWs connect external data as local tables [OK]

Common Mistakes:

• Confusing FDW with backup or caching features
• Thinking FDW encrypts data
• Assuming FDW only works with local data

2. Which of the following is the correct SQL command to create a foreign server named myserver using the postgres_fdw wrapper?

easy

A. CREATE FOREIGN SERVER myserver FOREIGN DATA WRAPPER postgres_fdw;

B. CREATE SERVER myserver FOREIGN DATA WRAPPER postgres_fdw;

C. CREATE SERVER myserver USING FOREIGN DATA WRAPPER postgres_fdw;

D. CREATE FOREIGN SERVER myserver USING postgres_fdw;

Solution

1. Step 1: Recall correct syntax for creating foreign server

   The correct syntax is: CREATE FOREIGN SERVER server_name FOREIGN DATA WRAPPER wrapper_name;

2. Step 2: Match options to syntax

   CREATE FOREIGN SERVER myserver FOREIGN DATA WRAPPER postgres_fdw; matches exactly. Options A and C miss the FOREIGN keyword before SERVER. CREATE FOREIGN SERVER myserver USING postgres_fdw; uses USING incorrectly.

3. Final Answer:

   CREATE FOREIGN SERVER myserver FOREIGN DATA WRAPPER postgres_fdw; -> Option A

4. Quick Check:

   CREATE FOREIGN SERVER ... FOREIGN DATA WRAPPER ... [OK]

Hint: Use CREATE FOREIGN SERVER ... FOREIGN DATA WRAPPER ... [OK]

Common Mistakes:

• Omitting FOREIGN keyword before SERVER
• Using USING instead of FOREIGN DATA WRAPPER
• Mixing order of keywords

3. Given the following commands in PostgreSQL:

CREATE EXTENSION IF NOT EXISTS postgres_fdw;
CREATE SERVER foreign_srv FOREIGN DATA WRAPPER postgres_fdw OPTIONS (host '192.168.1.10', dbname 'remotedb');
CREATE USER MAPPING FOR current_user SERVER foreign_srv OPTIONS (user 'remoteuser', password 'remotepass');
CREATE FOREIGN TABLE foreign_table (id INT, name TEXT) SERVER foreign_srv OPTIONS (schema_name 'public', table_name 'users');
SELECT * FROM foreign_table WHERE id = 1;

What will the SELECT query do?

medium

A. Retrieve rows from the remote table users in remotedb where id = 1

B. Retrieve rows from the local table named foreign_table

C. Cause a syntax error because foreign_table is not a local table

D. Return an empty result because no data is copied locally

Solution

1. Step 1: Understand foreign table mapping

   The foreign table foreign_table maps to the remote table users in the remotedb database on host 192.168.1.10.

2. Step 2: Analyze the SELECT query

   The SELECT queries the foreign_table, which fetches data from the remote users table where id = 1.

3. Final Answer:

   Retrieve rows from the remote table users in remotedb where id = 1 -> Option A

4. Quick Check:

   Foreign table SELECT fetches remote data [OK]

Hint: Foreign tables query remote data transparently [OK]

Common Mistakes:

• Thinking foreign_table is local data
• Expecting syntax error on foreign table
• Assuming data is copied locally automatically

4. You run this command:

CREATE FOREIGN TABLE foreign_table (id INT, name TEXT) SERVER foreign_srv OPTIONS (schema_name 'public', table_name 'users');

But get an error: ERROR: foreign server "foreign_srv" does not exist
What is the most likely cause?

medium

A. The user mapping for foreign_srv is missing

B. The foreign table syntax is incorrect and missing parentheses

C. The foreign server foreign_srv was not created before creating the foreign table

D. The remote table users does not exist in the remote database

Solution

1. Step 1: Interpret the error message

   The error says foreign server "foreign_srv" does not exist, meaning PostgreSQL cannot find that server definition.

2. Step 2: Check prerequisites for foreign table creation

   Before creating a foreign table, the foreign server must be created. If missing, this error occurs.

3. Final Answer:

   The foreign server foreign_srv was not created before creating the foreign table -> Option C

4. Quick Check:

   Foreign server must exist before foreign table [OK]

Hint: Create foreign server before foreign table [OK]

Common Mistakes:

• Ignoring the need to create foreign server first
• Assuming user mapping causes this error
• Thinking syntax error causes this message

5. You want to combine data from a local table orders and a remote table customers accessed via FDW named cust_fdw. Which approach correctly joins these tables in PostgreSQL?

hard

A. Create a view combining orders and customers on the remote server

B. Create foreign table for customers via cust_fdw, then run: SELECT * FROM orders JOIN customers ON orders.customer_id = customers.id;

C. Use dblink to fetch customers data inside a subquery, then join with orders

D. Copy remote customers data into a local table, then join locally

Solution

1. Step 1: Understand FDW usage for joining local and remote data

   FDW allows creating a foreign table for remote customers, so you can join it directly with local orders.

2. Step 2: Evaluate options for combining data

   Create foreign table for customers via cust_fdw, then run: SELECT * FROM orders JOIN customers ON orders.customer_id = customers.id; uses FDW foreign table and a direct join, which is correct and efficient. Copy remote customers data into a local table, then join locally copies data manually, less dynamic. Use dblink to fetch customers data inside a subquery, then join with orders uses dblink, more complex. Create a view combining orders and customers on the remote server creates a view on remote server, not accessible locally.

3. Final Answer:

   Create foreign table for customers via cust_fdw, then run: SELECT * FROM orders JOIN customers ON orders.customer_id = customers.id; -> Option B

4. Quick Check:

   FDW foreign table join local table directly [OK]

Hint: Create foreign table, then join like local tables [OK]

Common Mistakes:

• Trying to join without creating foreign table
• Copying remote data manually instead of FDW
• Using dblink unnecessarily for simple joins