Google BigQuery Storage V1 Client - Class CreateReadSessionRequest (1.9.0)
Stay organized with collections
Save and categorize content based on your preferences.
Reference documentation and code samples for the Google BigQuery Storage V1 Client class CreateReadSessionRequest.
Request message for CreateReadSession.
Generated from protobuf message google.cloud.bigquery.storage.v1.CreateReadSessionRequest
Namespace
Google \ Cloud \ BigQuery \ Storage \ V1Methods
__construct
Constructor.
| Parameters | |
|---|---|
| Name | Description |
data |
array
Optional. Data for populating the Message object. |
↳ parent |
string
Required. The request project that owns the session, in the form of |
↳ read_session |
Google\Cloud\BigQuery\Storage\V1\ReadSession
Required. Session to be created. |
↳ max_stream_count |
int
Max initial number of streams. If unset or zero, the server will provide a value of streams so as to produce reasonable throughput. Must be non-negative. The number of streams may be lower than the requested number, depending on the amount parallelism that is reasonable for the table. There is a default system max limit of 1,000. This must be greater than or equal to preferred_min_stream_count. Typically, clients should either leave this unset to let the system to determine an upper bound OR set this a size for the maximum "units of work" it can gracefully handle. |
↳ preferred_min_stream_count |
int
The minimum preferred stream count. This parameter can be used to inform the service that there is a desired lower bound on the number of streams. This is typically a target parallelism of the client (e.g. a Spark cluster with N-workers would set this to a low multiple of N to ensure good cluster utilization). The system will make a best effort to provide at least this number of streams, but in some cases might provide less. |
getParent
Required. The request project that owns the session, in the form of
projects/{project_id}.
| Returns | |
|---|---|
| Type | Description |
string |
|
setParent
Required. The request project that owns the session, in the form of
projects/{project_id}.
| Parameter | |
|---|---|
| Name | Description |
var |
string
|
| Returns | |
|---|---|
| Type | Description |
$this |
|
getReadSession
Required. Session to be created.
| Returns | |
|---|---|
| Type | Description |
Google\Cloud\BigQuery\Storage\V1\ReadSession|null |
|
hasReadSession
clearReadSession
setReadSession
Required. Session to be created.
| Parameter | |
|---|---|
| Name | Description |
var |
Google\Cloud\BigQuery\Storage\V1\ReadSession
|
| Returns | |
|---|---|
| Type | Description |
$this |
|
getMaxStreamCount
Max initial number of streams. If unset or zero, the server will provide a value of streams so as to produce reasonable throughput. Must be non-negative. The number of streams may be lower than the requested number, depending on the amount parallelism that is reasonable for the table.
There is a default system max limit of 1,000. This must be greater than or equal to preferred_min_stream_count. Typically, clients should either leave this unset to let the system to determine an upper bound OR set this a size for the maximum "units of work" it can gracefully handle.
| Returns | |
|---|---|
| Type | Description |
int |
|
setMaxStreamCount
Max initial number of streams. If unset or zero, the server will provide a value of streams so as to produce reasonable throughput. Must be non-negative. The number of streams may be lower than the requested number, depending on the amount parallelism that is reasonable for the table.
There is a default system max limit of 1,000. This must be greater than or equal to preferred_min_stream_count. Typically, clients should either leave this unset to let the system to determine an upper bound OR set this a size for the maximum "units of work" it can gracefully handle.
| Parameter | |
|---|---|
| Name | Description |
var |
int
|
| Returns | |
|---|---|
| Type | Description |
$this |
|
getPreferredMinStreamCount
The minimum preferred stream count. This parameter can be used to inform the service that there is a desired lower bound on the number of streams.
This is typically a target parallelism of the client (e.g. a Spark cluster with N-workers would set this to a low multiple of N to ensure good cluster utilization). The system will make a best effort to provide at least this number of streams, but in some cases might provide less.
| Returns | |
|---|---|
| Type | Description |
int |
|
setPreferredMinStreamCount
The minimum preferred stream count. This parameter can be used to inform the service that there is a desired lower bound on the number of streams.
This is typically a target parallelism of the client (e.g. a Spark cluster with N-workers would set this to a low multiple of N to ensure good cluster utilization). The system will make a best effort to provide at least this number of streams, but in some cases might provide less.
| Parameter | |
|---|---|
| Name | Description |
var |
int
|
| Returns | |
|---|---|
| Type | Description |
$this |
|
static::build
| Parameters | |
|---|---|
| Name | Description |
parent |
string
Required. The request project that owns the session, in the form of
|
readSession |
Google\Cloud\BigQuery\Storage\V1\ReadSession
Required. Session to be created. |
maxStreamCount |
int
Max initial number of streams. If unset or zero, the server will provide a value of streams so as to produce reasonable throughput. Must be non-negative. The number of streams may be lower than the requested number, depending on the amount parallelism that is reasonable for the table. There is a default system max limit of 1,000. This must be greater than or equal to preferred_min_stream_count. Typically, clients should either leave this unset to let the system to determine an upper bound OR set this a size for the maximum "units of work" it can gracefully handle. |
| Returns | |
|---|---|
| Type | Description |
Google\Cloud\BigQuery\Storage\V1\CreateReadSessionRequest |
|