Metadata-Version: 2.1
Name: devart-excelonline-connector
Version: 1.1.0
Summary: New level of functionality and performance in data access via Python
Home-page: https://devart.com
Author: Devart
Author-email: support@devart.com
License: Other/Proprietary License
Project-URL: Homepage, http://devart.com/python/excelonline
Project-URL: Download, http://devart.com/python/excelonline/download.html
Project-URL: History, http://devart.com/python/excelonline/revision_history.html
Project-URL: License, https://www.devart.com/python/eula.html
Project-URL: Documentation, http://docs.devart.com/python/excelonline/overview.htm
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE

# Python Connector for Microsoft Excel Online #

Python Connector for Microsoft Excel Online is a connectivity solution
for accessing Microsoft Excel Online from Python applications to read and
update data. It fully implements the Python DB API 2.0 specification.
The connector is distributed as a wheel package for Windows and Windows
Server.

Standard SQL syntax

The connector fully supports the ANSI SQL standard and lets you execute SQL
statements against your Microsoft Excel Online data just like you would
normally work with relational databases. Simple queries are directly converted
to Microsoft Excel Online API calls and executed on the Microsoft Excel Online
side.

## Connecting ##

To connect to Microsoft Excel Online, import the connector and use
the `connect()` method with your connection parameters.

### Import the connector ###

First, import the Microsoft Excel Online connector module:

```
import devart.excelonline as excelonline
```

### Establish a connection ###

Call the `connect()` method and obtain a `connection` object.

```
response = excelonline.signin()
my_workbook = excelonline.getworkbook()
my_connection = excelonline.connect(
    WorkbookId=my_workbook["Workbook Id"]
    RefreshToken=response["Refresh Token"]
)
```

Replace the example values with your actual connection values.

## Querying data ##

Once connected to Microsoft Excel Online, you can execute SQL queries
to retrieve data from your Excel workbooks.

### Execute a query ###

Create a `cursor` object using the `cursor()` connection method.
```
my_cursor = my_connection.cursor()
```
Execute a SQL query using the `execute()` cursor method.
```
my_cursor.execute("SELECT * FROM all_types")
```
Retrieve results using one of the `fetch*()` methods.
```
for row in my_cursor.fetchall(): 
    print(row)
```

### Parameterized queries ###

You can use parameterized queries to pass variable values to your SQL statements. This allows you to reuse the same query with different data and helps to prevent SQL injection attacks.

Pass parameters as a list or tuple to the `execute()` method:

```
query = "SELECT Id, Name FROM Contact WHERE Name = ? AND Email = ?"
params = ["Jordan Sanders", "jordansanders@example.com"]
my_cursor.execute(query, params)
results = my_cursor.fetchall()
for row in results:
    print(row)
```

Each placeholder `?` in the query is replaced with a corresponding value from the parameter list.

## Ordering and activating the license ##

You can purchase a license for the connector on the ordering page:             
https://www.devart.com/python/excelonline/ordering.html

To activate the license, follow the instructions in the documentation:             
https://docs.devart.com/python/excelonline/activate-a-license.htm

## What's new ##

Python Connector for Microsoft Excel Online 1.1

- Added support for Python 3.14
