---
title: "system.db.refresh"
description: "This function will programmatically cause a SQL Query or DB Browse property binding to execute immediately."
---

# system.db.refresh

> This function will programmatically cause a SQL Query or DB Browse property binding to execute immediately.

This function is used in **Python Scripting**.
## Description
This function will programmatically cause a [SQL Query](https://docs.inductiveautomation.com/display/DOC79/SQL+Query+Binding) or DB Browse property binding to execute immediately. This is most often used for bindings that are set to Polling - Off. In this way, you cause a binding to execute on demand, when you know that the results of its query will return a new result. To use it, you simply specify the component and name of the property on whose binding you'd like to refresh.

## Client Permission Restrictions
[Permission Type](projects\project-properties\project-properties.md#client---permissions): Legacy Database Access

Client access to this scripting function is blocked to users that do not meet the role/zone requirements for the above permission type. This function is unaffected when run in the Gateway scope.

## Syntax
`system.db.refresh(component, propertyName)`

### Parameters
Type | Parameter | Description 
------- | ------- | ------
JComponent | `component` | The component whose property you want to refresh
String  | `propertyName` | The name of the property that has a SQL Query binding that needs to be refreshed

### Returns

**Boolean** - True (1) if the property was found and refreshed successfully.

### Scope

All

## Code Examples
```python title="Example #1"
# This example could be placed in the actionPerformed event of a Button, to be used to refresh the data of a Table. 
# Remember to use the scripting name of the property that you're trying to refresh, and that the property names are case-sensitive.
  
table = event.source.parent.getComponent("Table")
system.db.refresh(table, "data")
```