BigQuery Client - Class Model (1.27.0)

Reference documentation and code samples for the BigQuery Client class Model.

A BigQuery ML Model represents what an ML system has learned from the training data.

Namespace

Google \ Cloud \ BigQuery

Methods

__construct

Parameters
Name
Description
connection
Google\Cloud\BigQuery\Connection\ConnectionInterface

Represents a connection to BigQuery.

id
string

The model's ID.

datasetId
string

The dataset's ID.

projectId
string

The project's ID.

info
array

[optional] The model data.

location
array

[optional] The location of the model.

info

Retrieves the model's details. If no model data is cached, a network request will be made to retrieve it.

Please note that Model instances created by list calls may not contain a full representation of the model resource. To obtain a full resource on a Model instance, call Google\Cloud\BigQuery\Model::reload() .

Example:

 $info = $model->info();
echo $info['modelType']; 
Parameter
Name
Description
options
array

[optional] Configuration options.

Returns
Type
Description
array

reload

Triggers a network request to reload the model's details.

Example:

 $model->reload();
$info = $model->info();
echo $info['modelType']; 
Parameter
Name
Description
options
array

[optional] Configuration options.

Returns
Type
Description
array

id

Retrieves the model's ID.

Example:

 echo $model->id(); 
Returns
Type
Description
string

identity

Retrieves the model's identity.

An identity provides a description of a resource that is nested in nature.

Example:

 echo $model->identity()['modelId']; 
Returns
Type
Description
array

delete

Delete the model.

Please note that by default the library will not attempt to retry this call on your behalf.

Example:

 $model->delete(); 
Parameter
Name
Description
options
array

[optional] Configuration options.

exists

Check whether or not the model exists.

Example:

 echo $model->exists(); 
Parameter
Name
Description
options
array

[optional] Configuration options.

Returns
Type
Description
bool

update

Update the model.

Providing an etag key as part of $metadata will enable simultaneous update protection. This is useful in preventing override of modifications made by another user. The resource's current etag can be obtained via a GET request on the resource.

Please note that by default this call will not automatically retry on your behalf unless an etag is set.

Example:

 $model->update([
    'friendlyName' => 'My ML model'
]); 
Parameters
Name
Description
metadata
array

The available options for metadata are outlined at the Model Resource API docs

options
array

[optional] Configuration options.

Returns
Type
Description
array

extract

Returns an extract job configuration to be passed to either BigQueryClient::runJob() or BigQueryClient::startJob() . A configuration can be built using fluent setters or by providing a full set of options at once.

Example:

 $destinationObject = $storage->bucket('myBucket')->object('modelOutput');
$extractJobConfig = $model->extract($destinationObject); 
Parameters
Name
Description
destination
string| Google\Cloud\Storage\StorageObject

The destination object. May be a Google\Cloud\Storage\StorageObject or a URI pointing to a Google Cloud Storage object in the format of gs://{bucket-name}/{object-name} .

options
array

[optional] Please see the upstream API documentation for Job configuration for the available options.

Create a Mobile Website
View Site in Mobile | Classic
Share by: