Loading CSV and Excel files in LangChain

Introduction

Loading CSV and Excel files lets you bring data from spreadsheets into your program easily. This helps you work with real-world data like lists, tables, or reports.

You have a spreadsheet with customer information and want to analyze it.

You want to read a CSV file with sales data to create charts.

You need to load an Excel file with multiple sheets for a report.

You want to process data exported from another program in CSV or Excel format.

Syntax

LangChain

from langchain.document_loaders import CSVLoader, ExcelLoader

# Load CSV file
csv_loader = CSVLoader(file_path="path/to/file.csv")
csv_docs = csv_loader.load()

# Load Excel file
excel_loader = ExcelLoader(file_path="path/to/file.xlsx")
excel_docs = excel_loader.load()

Use CSVLoader for CSV files and ExcelLoader for Excel files.

The load() method reads the file and returns documents you can use in LangChain.

Examples

This loads a CSV file named customers.csv from the data folder.

LangChain

from langchain.document_loaders import CSVLoader

csv_loader = CSVLoader(file_path="data/customers.csv")
docs = csv_loader.load()

This loads an Excel file named sales.xlsx from the data folder.

LangChain

from langchain.document_loaders import ExcelLoader

excel_loader = ExcelLoader(file_path="data/sales.xlsx")
docs = excel_loader.load()

This loads only the "Summary" sheet from the Excel file.

LangChain

from langchain.document_loaders import ExcelLoader

# Load specific sheet by name
excel_loader = ExcelLoader(file_path="data/report.xlsx", sheet_name="Summary")
docs = excel_loader.load()

Sample Program

This program loads two files: a CSV and an Excel file. It prints how many documents each file contains after loading.

LangChain

from langchain.document_loaders import CSVLoader, ExcelLoader

# Load CSV file
csv_loader = CSVLoader(file_path="example_data.csv")
csv_docs = csv_loader.load()
print(f"Loaded {len(csv_docs)} documents from CSV file.")

# Load Excel file
excel_loader = ExcelLoader(file_path="example_data.xlsx")
excel_docs = excel_loader.load()
print(f"Loaded {len(excel_docs)} documents from Excel file.")

Important Notes

Make sure the file paths are correct and files exist to avoid errors.

Excel files can have multiple sheets; you can specify which sheet to load.

The loaded documents are ready to be used in LangChain workflows like text processing or question answering.

Summary

Use CSVLoader and ExcelLoader to load spreadsheet files easily.

Loading files turns spreadsheet data into documents LangChain can work with.

You can specify sheet names for Excel files to load only needed data.

Practice

1. What is the main purpose of using CSVLoader in LangChain?

easy

A. To load CSV files and convert their data into documents LangChain can process

B. To save data into CSV files from LangChain documents

C. To visualize CSV data in charts

D. To convert Excel files into CSV format

Solution

1. Step 1: Understand CSVLoader's role

   CSVLoader is designed to read CSV files and transform their content into a format LangChain can use.

2. Step 2: Differentiate from other options

   Saving, visualizing, or converting files are not functions of CSVLoader.

3. Final Answer:

   To load CSV files and convert their data into documents LangChain can process -> Option A

4. Quick Check:

   CSVLoader loads CSV files = A [OK]

Hint: CSVLoader reads CSV files into LangChain documents [OK]

Common Mistakes:

• Thinking CSVLoader saves or visualizes data
• Confusing CSVLoader with ExcelLoader
• Assuming CSVLoader converts file formats

2. Which of the following is the correct way to load an Excel file named data.xlsx using LangChain's ExcelLoader?

easy

A. loader = ExcelLoader.open('data.xlsx')

B. loader = ExcelLoader.load('data.xlsx')

C. loader = ExcelLoader.read('data.xlsx')

D. loader = ExcelLoader('data.xlsx')

Solution

1. Step 1: Recall ExcelLoader instantiation

   ExcelLoader is instantiated by passing the file path as a string to its constructor.

2. Step 2: Identify correct syntax

   Only ExcelLoader('data.xlsx') correctly creates a loader instance; other methods like load(), read(), open() are invalid here.

3. Final Answer:

   loader = ExcelLoader('data.xlsx') -> Option D

4. Quick Check:

   Use constructor with filename = A [OK]

Hint: Use ExcelLoader('filename.xlsx') to create loader [OK]

Common Mistakes:

• Using non-existent methods like load() or read() on ExcelLoader
• Forgetting to pass filename as a string
• Trying to open file with open() method on loader

3. Given the code:

from langchain.document_loaders import CSVLoader
loader = CSVLoader('contacts.csv')
docs = loader.load()

What will docs contain after running this code?

medium

A. A dictionary mapping column names to values

B. A list of document objects representing rows from the CSV file

C. An error because CSVLoader requires sheet name

D. A single string with all CSV content

Solution

1. Step 1: Understand CSVLoader.load() output

   The load() method returns a list of document objects, each representing a row or chunk from the CSV file.

2. Step 2: Eliminate incorrect options

   It does not return a single string, dictionary, or error for missing sheet name (sheet names apply to ExcelLoader).

3. Final Answer:

   A list of document objects representing rows from the CSV file -> Option B

4. Quick Check:

   load() returns list of documents = D [OK]

Hint: load() returns list of documents, not raw strings [OK]

Common Mistakes:

• Expecting a string or dictionary instead of documents list
• Confusing CSVLoader with ExcelLoader sheet requirements
• Assuming load() returns raw file content

4. What is wrong with this code snippet for loading an Excel file?

from langchain.document_loaders import ExcelLoader
loader = ExcelLoader('data.xlsx', sheet_name='Sheet1')
docs = loader.load()

medium

A. The file path must be an absolute path, not relative

B. ExcelLoader does not accept sheet names when loading files

C. The parameter should be named sheet_names (plural), not sheet_name

D. The load() method must be called with the sheet name argument

Solution

1. Step 1: Check ExcelLoader sheet name parameter

   ExcelLoader expects the parameter sheet_names (plural) as a list of sheet names, not sheet_name.

2. Step 2: Validate other options

   ExcelLoader does accept sheet names, relative paths are allowed, and load() does not take sheet name arguments.

3. Final Answer:

   The parameter should be named sheet_names (plural), not sheet_name -> Option C

4. Quick Check:

   Use sheet_names list parameter = C [OK]

Hint: Use sheet_names=['Sheet1'] not sheet_name='Sheet1' [OK]

Common Mistakes:

• Using singular sheet_name instead of plural sheet_names
• Thinking load() needs sheet name argument
• Believing relative paths are invalid

5. You want to load only the 'Sales' sheet from an Excel file report.xlsx using LangChain. Which code snippet correctly does this?

hard

A. loader = ExcelLoader('report.xlsx', sheet_names=['Sales'])
docs = loader.load()

B. loader = ExcelLoader('report.xlsx', sheet_name='Sales')
docs = loader.load()

C. loader = ExcelLoader('report.xlsx')
docs = loader.load(sheet_name='Sales')

D. loader = ExcelLoader('report.xlsx')
docs = loader.load()
filter_docs = [d for d in docs if d.metadata['sheet'] == 'Sales']

Solution

1. Step 1: Use correct parameter to specify sheets

   ExcelLoader accepts sheet_names as a list of sheet names to load only those sheets.

2. Step 2: Confirm load() usage

   load() does not take sheet names; they must be specified when creating the loader.

3. Step 3: Evaluate options

   loader = ExcelLoader('report.xlsx', sheet_name='Sales') docs = loader.load() uses sheet_name (singular), incorrect. loader = ExcelLoader('report.xlsx') docs = loader.load(sheet_name='Sales') passes sheet name to load(), invalid. loader = ExcelLoader('report.xlsx') docs = loader.load() filter_docs = [d for d in docs if d.metadata['sheet'] == 'Sales'] loads all sheets then filters manually, inefficient. Only loader = ExcelLoader('report.xlsx', sheet_names=['Sales']) docs = loader.load() correctly uses sheet_names=['Sales'] at loader creation.

4. Final Answer:

   loader = ExcelLoader('report.xlsx', sheet_names=['Sales']) docs = loader.load() -> Option A

5. Quick Check:

   Use sheet_names list at loader creation = B [OK]

Hint: Pass sheet_names=['SheetName'] when creating ExcelLoader [OK]

Common Mistakes:

• Using singular sheet_name parameter
• Passing sheet name to load() method
• Loading all sheets then filtering manually