Class ArrayQueryParameter (3.36.0)
Note: Some or all of the information on this page might not apply
to Trusted Cloud. For a list of services that are available in
Trusted Cloud, see Services available for
Trusted Cloud .
Version latestkeyboard_arrow_down
ArrayQueryParameter ( name , array_type , values )
Named / positional query parameters for array values.
Parameters
Name
Description
name
Optional[str]
Parameter name, used via @foo
syntax. If None, the parameter can only be addressed via position (?
).
array_type
Union[str, ScalarQueryParameterType, StructQueryParameterType]
The type of array elements. If given as a string, it must be one of 'STRING'
, 'INT64'
, 'FLOAT64'
, 'NUMERIC'
, 'BIGNUMERIC'
, 'BOOL'
, 'TIMESTAMP'
, 'DATE'
, or 'STRUCT'
/'RECORD'
. If the type is 'STRUCT'
/'RECORD'
and values
is empty, the exact item type cannot be deduced, thus a StructQueryParameterType
instance needs to be passed in.
values
List[appropriate type]
The parameter array values.
Methods
from_api_repr
from_api_repr ( resource : dict ) - > google . cloud . bigquery . query . ArrayQueryParameter
Factory: construct parameter from JSON resource.
Parameter
Name
Description
resource
Dict
JSON mapping of parameter
Returns
Type
Description
google.cloud.bigquery.query.ArrayQueryParameter
Instance
positional
positional (
array_type : str , values : list
) - > google . cloud . bigquery . query . ArrayQueryParameter
Factory for positional parameters.
Parameters
Name
Description
array_type
Union[str, ScalarQueryParameterType, StructQueryParameterType]
The type of array elements. If given as a string, it must be one of 'STRING'
, 'INT64'
, 'FLOAT64'
, 'NUMERIC'
, 'BIGNUMERIC'
, 'BOOL'
, 'TIMESTAMP'
, 'DATE'
, or 'STRUCT'
/'RECORD'
. If the type is 'STRUCT'
/'RECORD'
and values
is empty, the exact item type cannot be deduced, thus a StructQueryParameterType
instance needs to be passed in.
values
List[appropriate type]
The parameter array values.
Returns
Type
Description
google.cloud.bigquery.query.ArrayQueryParameter
Instance without name
to_api_repr
Construct JSON API representation for the parameter.
Returns
Type
Description
Dict
JSON mapping
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License , and code samples are licensed under the Apache 2.0 License . For details, see the Google Developers Site Policies . Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-28 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-28 UTC."],[],[],null,["# Class ArrayQueryParameter (3.36.0)\n\nVersion latestkeyboard_arrow_down\n\n- [3.36.0 (latest)](/python/docs/reference/bigquery/latest/google.cloud.bigquery.query.ArrayQueryParameter)\n- [3.35.1](/python/docs/reference/bigquery/3.35.1/google.cloud.bigquery.query.ArrayQueryParameter)\n- [3.34.0](/python/docs/reference/bigquery/3.34.0/google.cloud.bigquery.query.ArrayQueryParameter)\n- [3.33.0](/python/docs/reference/bigquery/3.33.0/google.cloud.bigquery.query.ArrayQueryParameter)\n- [3.31.0](/python/docs/reference/bigquery/3.31.0/google.cloud.bigquery.query.ArrayQueryParameter)\n- [3.30.0](/python/docs/reference/bigquery/3.30.0/google.cloud.bigquery.query.ArrayQueryParameter)\n- [3.29.0](/python/docs/reference/bigquery/3.29.0/google.cloud.bigquery.query.ArrayQueryParameter)\n- [3.27.0](/python/docs/reference/bigquery/3.27.0/google.cloud.bigquery.query.ArrayQueryParameter)\n- [3.26.0](/python/docs/reference/bigquery/3.26.0/google.cloud.bigquery.query.ArrayQueryParameter)\n- [3.25.0](/python/docs/reference/bigquery/3.25.0/google.cloud.bigquery.query.ArrayQueryParameter)\n- [3.24.0](/python/docs/reference/bigquery/3.24.0/google.cloud.bigquery.query.ArrayQueryParameter)\n- [3.23.1](/python/docs/reference/bigquery/3.23.1/google.cloud.bigquery.query.ArrayQueryParameter)\n- [3.22.0](/python/docs/reference/bigquery/3.22.0/google.cloud.bigquery.query.ArrayQueryParameter)\n- [3.21.0](/python/docs/reference/bigquery/3.21.0/google.cloud.bigquery.query.ArrayQueryParameter)\n- [3.20.1](/python/docs/reference/bigquery/3.20.1/google.cloud.bigquery.query.ArrayQueryParameter)\n- [3.19.0](/python/docs/reference/bigquery/3.19.0/google.cloud.bigquery.query.ArrayQueryParameter)\n- [3.18.0](/python/docs/reference/bigquery/3.18.0/google.cloud.bigquery.query.ArrayQueryParameter)\n- [3.17.2](/python/docs/reference/bigquery/3.17.2/google.cloud.bigquery.query.ArrayQueryParameter)\n- [3.16.0](/python/docs/reference/bigquery/3.16.0/google.cloud.bigquery.query.ArrayQueryParameter)\n- [3.15.0](/python/docs/reference/bigquery/3.15.0/google.cloud.bigquery.query.ArrayQueryParameter)\n- [3.14.1](/python/docs/reference/bigquery/3.14.1/google.cloud.bigquery.query.ArrayQueryParameter)\n- [3.13.0](/python/docs/reference/bigquery/3.13.0/google.cloud.bigquery.query.ArrayQueryParameter)\n- [3.12.0](/python/docs/reference/bigquery/3.12.0/google.cloud.bigquery.query.ArrayQueryParameter)\n- [3.11.4](/python/docs/reference/bigquery/3.11.4/google.cloud.bigquery.query.ArrayQueryParameter)\n- [3.4.0](/python/docs/reference/bigquery/3.4.0/google.cloud.bigquery.query.ArrayQueryParameter)\n- [3.3.6](/python/docs/reference/bigquery/3.3.6/google.cloud.bigquery.query.ArrayQueryParameter)\n- [3.2.0](/python/docs/reference/bigquery/3.2.0/google.cloud.bigquery.query.ArrayQueryParameter)\n- [3.1.0](/python/docs/reference/bigquery/3.1.0/google.cloud.bigquery.query.ArrayQueryParameter)\n- [3.0.1](/python/docs/reference/bigquery/3.0.1/google.cloud.bigquery.query.ArrayQueryParameter)\n- [2.34.4](/python/docs/reference/bigquery/2.34.4/google.cloud.bigquery.query.ArrayQueryParameter)\n- [2.33.0](/python/docs/reference/bigquery/2.33.0/google.cloud.bigquery.query.ArrayQueryParameter)\n- [2.32.0](/python/docs/reference/bigquery/2.32.0/google.cloud.bigquery.query.ArrayQueryParameter)\n- [2.31.0](/python/docs/reference/bigquery/2.31.0/google.cloud.bigquery.query.ArrayQueryParameter)\n- [2.30.1](/python/docs/reference/bigquery/2.30.1/google.cloud.bigquery.query.ArrayQueryParameter)\n- [2.29.0](/python/docs/reference/bigquery/2.29.0/google.cloud.bigquery.query.ArrayQueryParameter)\n- [2.28.1](/python/docs/reference/bigquery/2.28.1/google.cloud.bigquery.query.ArrayQueryParameter)\n- [2.27.1](/python/docs/reference/bigquery/2.27.1/google.cloud.bigquery.query.ArrayQueryParameter)\n- [2.26.0](/python/docs/reference/bigquery/2.26.0/google.cloud.bigquery.query.ArrayQueryParameter)\n- [2.25.2](/python/docs/reference/bigquery/2.25.2/google.cloud.bigquery.query.ArrayQueryParameter)\n- [2.24.1](/python/docs/reference/bigquery/2.24.1/google.cloud.bigquery.query.ArrayQueryParameter)\n- [2.23.3](/python/docs/reference/bigquery/2.23.3/google.cloud.bigquery.query.ArrayQueryParameter)\n- [2.22.1](/python/docs/reference/bigquery/2.22.1/google.cloud.bigquery.query.ArrayQueryParameter)\n- [2.21.0](/python/docs/reference/bigquery/2.21.0/google.cloud.bigquery.query.ArrayQueryParameter)\n- [2.20.0](/python/docs/reference/bigquery/2.20.0/google.cloud.bigquery.query.ArrayQueryParameter)\n- [2.19.0](/python/docs/reference/bigquery/2.19.0/google.cloud.bigquery.query.ArrayQueryParameter)\n- [2.18.0](/python/docs/reference/bigquery/2.18.0/google.cloud.bigquery.query.ArrayQueryParameter)\n- [2.17.0](/python/docs/reference/bigquery/2.17.0/google.cloud.bigquery.query.ArrayQueryParameter)\n- [2.16.1](/python/docs/reference/bigquery/2.16.1/google.cloud.bigquery.query.ArrayQueryParameter)\n- [2.15.0](/python/docs/reference/bigquery/2.15.0/google.cloud.bigquery.query.ArrayQueryParameter)\n- [2.14.0](/python/docs/reference/bigquery/2.14.0/google.cloud.bigquery.query.ArrayQueryParameter)\n- [2.13.1](/python/docs/reference/bigquery/2.13.1/google.cloud.bigquery.query.ArrayQueryParameter)\n- [2.12.0](/python/docs/reference/bigquery/2.12.0/google.cloud.bigquery.query.ArrayQueryParameter)\n- [2.11.0](/python/docs/reference/bigquery/2.11.0/google.cloud.bigquery.query.ArrayQueryParameter)\n- [2.10.0](/python/docs/reference/bigquery/2.10.0/google.cloud.bigquery.query.ArrayQueryParameter)\n- [2.9.0](/python/docs/reference/bigquery/2.9.0/google.cloud.bigquery.query.ArrayQueryParameter)\n- [2.8.0](/python/docs/reference/bigquery/2.8.0/google.cloud.bigquery.query.ArrayQueryParameter)\n- [2.7.0](/python/docs/reference/bigquery/2.7.0/google.cloud.bigquery.query.ArrayQueryParameter)\n- [2.6.2](/python/docs/reference/bigquery/2.6.2/google.cloud.bigquery.query.ArrayQueryParameter)\n- [2.5.0](/python/docs/reference/bigquery/2.5.0/google.cloud.bigquery.query.ArrayQueryParameter)\n- [2.4.0](/python/docs/reference/bigquery/2.4.0/google.cloud.bigquery.query.ArrayQueryParameter)\n- [2.3.1](/python/docs/reference/bigquery/2.3.1/google.cloud.bigquery.query.ArrayQueryParameter)\n- [2.2.0](/python/docs/reference/bigquery/2.2.0/google.cloud.bigquery.query.ArrayQueryParameter)\n- [2.1.0](/python/docs/reference/bigquery/2.1.0/google.cloud.bigquery.query.ArrayQueryParameter)\n- [2.0.0](/python/docs/reference/bigquery/2.0.0/google.cloud.bigquery.query.ArrayQueryParameter)\n- [1.28.2](/python/docs/reference/bigquery/1.28.2/google.cloud.bigquery.query.ArrayQueryParameter)\n- [1.27.2](/python/docs/reference/bigquery/1.27.2/google.cloud.bigquery.query.ArrayQueryParameter)\n- [1.26.1](/python/docs/reference/bigquery/1.26.1/google.cloud.bigquery.query.ArrayQueryParameter)\n- [1.25.0](/python/docs/reference/bigquery/1.25.0/google.cloud.bigquery.query.ArrayQueryParameter)\n- [1.24.0](/python/docs/reference/bigquery/1.24.0/google.cloud.bigquery.query.ArrayQueryParameter)\n- [1.23.1](/python/docs/reference/bigquery/1.23.1/google.cloud.bigquery.query.ArrayQueryParameter)\n- [1.22.0](/python/docs/reference/bigquery/1.22.0/google.cloud.bigquery.query.ArrayQueryParameter)\n- [1.21.0](/python/docs/reference/bigquery/1.21.0/google.cloud.bigquery.query.ArrayQueryParameter)\n- [1.20.0](/python/docs/reference/bigquery/1.20.0/google.cloud.bigquery.query.ArrayQueryParameter)\n- [1.19.0](/python/docs/reference/bigquery/1.19.0/google.cloud.bigquery.query.ArrayQueryParameter)\n- [1.18.0](/python/docs/reference/bigquery/1.18.0/google.cloud.bigquery.query.ArrayQueryParameter)\n- [1.17.0](/python/docs/reference/bigquery/1.17.0/google.cloud.bigquery.query.ArrayQueryParameter)\n- [1.16.0](/python/docs/reference/bigquery/1.16.0/google.cloud.bigquery.query.ArrayQueryParameter) \n\n ArrayQueryParameter(name, array_type, values)\n\nNamed / positional query parameters for array values.\n\nMethods\n-------\n\n### from_api_repr\n\n from_api_repr(resource: dict) -\u003e google.cloud.bigquery.query.ArrayQueryParameter\n\nFactory: construct parameter from JSON resource.\n\n### positional\n\n positional(\n array_type: str, values: list\n ) -\u003e google.cloud.bigquery.query.ArrayQueryParameter\n\nFactory for positional parameters.\n\n### to_api_repr\n\n to_api_repr() -\u003e dict\n\nConstruct JSON API representation for the parameter."]]