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.
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 {@see}.
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 {@see} or a URI pointing to a Google Cloud Storage object in the format of |
options | array [optional] Please see the upstream API documentation for Job configuration for the available options. |
| Returns | |
|---|---|
| Type | Description |
Google\Cloud\BigQuery\ExtractJobConfiguration | |