# Variable ## *class* Variable Variables represent the "columns" in tables (and uploads), and have certain metadata as well as detailed univariate summary statistics associated with them. Use this class to interface with variables and their metadata. ## Constructors

Method	Description
`query.list_variables`([max_results])	List all variables in a (completed) query's results.
`table.list_variables`([max_results])	List all variables in a table.
`upload.list_variables`([max_results])	List all variables in a (completed) upload.
`query.variable`(variable_name)	Construct a reference to a variable within a query's results based on its (case-insensitive) name.
`table.variable`(variable_name)	Construct a reference to a variable within a table based on its (case-insensitive) name.
`upload.variable`(variable_name)	Construct a reference to a variable within an upload based on its (case-insensitive) name.

## Examples {% tabs %} {% tab title="Basics" %}

table = redivis.organization("Demo").dataset("iris_species").table("iris")

variable = table.variable("sepalLengthCm")

variable.exists() # -> True
variable.get(wait_for_statistics=True) 

print(variable.properties)

{
"kind": "variable",
... (see variable resource definition)
}

print(variable.get_statistics())
{
  "kind": "variableStatistics"
  "status": "completed",
  "count": 150,
  "numDistinct": 35,
  "min": 4.3,
  "max": 7.9,
  "mean": 5.8433333333333355,
  "approxMedian": 0.8280661279778625,
  ...
}

{% endtab %} {% endtabs %} ## Attributes | **`properties`** | A dict containing the [API resource representation of the variable](/api/resource-definitions/variable.md#base-definition). This will only be populated after certain methods are called, particularly the `get` method, and will otherwise be `None`. | | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | **`table`** | A reference to the [Table](/api/client-libraries/redivis-python/reference/table.md) instance that constructed this variable. Will be `None` if the variable belongs to an upload. | | **`upload`** | A reference to the [Upload](/api/client-libraries/redivis-python/reference/upload.md) instance that constructed this variable. Will be `None` if the variable belongs to a table. | ## Methods

Name	Description
`variable.get`()	Gets the variable, after which the `properties` attribute will be populated according to the variable.get resource definition.
`variable.get_statistics`()	Gets the variable statistics, returning a dict corresponding the variableStatistics resource definition.
`variable.exists`()	List all visible datasets owned by the user.
`variable.update`([*, label, description, ...])	Update a variable's metadata.

--- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.redivis.com/api/client-libraries/redivis-python/reference/variable.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.