Reference documentation and code samples for the BigQuery Storage V1 API class Google::Cloud::Bigquery::Storage::V1::CreateReadSessionRequest.
Request message for CreateReadSession.
Inherits
Object
Extended By
Google::Protobuf::MessageExts::ClassMethods
Includes
Google::Protobuf::MessageExts
Methods
#max_stream_count
defmax_stream_count()->::Integer
Returns
(::Integer) — 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.
#max_stream_count=
defmax_stream_count=(value)->::Integer
Parameter
value (::Integer) — 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
(::Integer) — 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.
#parent
defparent()->::String
Returns
(::String) — Required. The request project that owns the session, in the form of
projects/{project_id}.
#parent=
defparent=(value)->::String
Parameter
value (::String) — Required. The request project that owns the session, in the form of
projects/{project_id}.
Returns
(::String) — Required. The request project that owns the session, in the form of
projects/{project_id}.
#preferred_min_stream_count
defpreferred_min_stream_count()->::Integer
Returns
(::Integer) — 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.
#preferred_min_stream_count=
defpreferred_min_stream_count=(value)->::Integer
Parameter
value (::Integer) — 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
(::Integer) — 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.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-09 UTC."],[],[],null,["# BigQuery Storage V1 API - Class Google::Cloud::Bigquery::Storage::V1::CreateReadSessionRequest (v1.4.0)\n\nVersion latestkeyboard_arrow_down\n\n- [1.4.0 (latest)](/ruby/docs/reference/google-cloud-bigquery-storage-v1/latest/Google-Cloud-Bigquery-Storage-V1-CreateReadSessionRequest)\n- [1.3.1](/ruby/docs/reference/google-cloud-bigquery-storage-v1/1.3.1/Google-Cloud-Bigquery-Storage-V1-CreateReadSessionRequest)\n- [1.2.0](/ruby/docs/reference/google-cloud-bigquery-storage-v1/1.2.0/Google-Cloud-Bigquery-Storage-V1-CreateReadSessionRequest)\n- [1.1.0](/ruby/docs/reference/google-cloud-bigquery-storage-v1/1.1.0/Google-Cloud-Bigquery-Storage-V1-CreateReadSessionRequest)\n- [1.0.1](/ruby/docs/reference/google-cloud-bigquery-storage-v1/1.0.1/Google-Cloud-Bigquery-Storage-V1-CreateReadSessionRequest)\n- [0.27.0](/ruby/docs/reference/google-cloud-bigquery-storage-v1/0.27.0/Google-Cloud-Bigquery-Storage-V1-CreateReadSessionRequest)\n- [0.26.0](/ruby/docs/reference/google-cloud-bigquery-storage-v1/0.26.0/Google-Cloud-Bigquery-Storage-V1-CreateReadSessionRequest)\n- [0.25.2](/ruby/docs/reference/google-cloud-bigquery-storage-v1/0.25.2/Google-Cloud-Bigquery-Storage-V1-CreateReadSessionRequest)\n- [0.24.0](/ruby/docs/reference/google-cloud-bigquery-storage-v1/0.24.0/Google-Cloud-Bigquery-Storage-V1-CreateReadSessionRequest)\n- [0.23.0](/ruby/docs/reference/google-cloud-bigquery-storage-v1/0.23.0/Google-Cloud-Bigquery-Storage-V1-CreateReadSessionRequest)\n- [0.22.0](/ruby/docs/reference/google-cloud-bigquery-storage-v1/0.22.0/Google-Cloud-Bigquery-Storage-V1-CreateReadSessionRequest)\n- [0.21.0](/ruby/docs/reference/google-cloud-bigquery-storage-v1/0.21.0/Google-Cloud-Bigquery-Storage-V1-CreateReadSessionRequest)\n- [0.20.0](/ruby/docs/reference/google-cloud-bigquery-storage-v1/0.20.0/Google-Cloud-Bigquery-Storage-V1-CreateReadSessionRequest)\n- [0.19.1](/ruby/docs/reference/google-cloud-bigquery-storage-v1/0.19.1/Google-Cloud-Bigquery-Storage-V1-CreateReadSessionRequest)\n- [0.18.0](/ruby/docs/reference/google-cloud-bigquery-storage-v1/0.18.0/Google-Cloud-Bigquery-Storage-V1-CreateReadSessionRequest)\n- [0.17.0](/ruby/docs/reference/google-cloud-bigquery-storage-v1/0.17.0/Google-Cloud-Bigquery-Storage-V1-CreateReadSessionRequest)\n- [0.16.0](/ruby/docs/reference/google-cloud-bigquery-storage-v1/0.16.0/Google-Cloud-Bigquery-Storage-V1-CreateReadSessionRequest)\n- [0.15.1](/ruby/docs/reference/google-cloud-bigquery-storage-v1/0.15.1/Google-Cloud-Bigquery-Storage-V1-CreateReadSessionRequest)\n- [0.14.0](/ruby/docs/reference/google-cloud-bigquery-storage-v1/0.14.0/Google-Cloud-Bigquery-Storage-V1-CreateReadSessionRequest)\n- [0.13.0](/ruby/docs/reference/google-cloud-bigquery-storage-v1/0.13.0/Google-Cloud-Bigquery-Storage-V1-CreateReadSessionRequest)\n- [0.12.0](/ruby/docs/reference/google-cloud-bigquery-storage-v1/0.12.0/Google-Cloud-Bigquery-Storage-V1-CreateReadSessionRequest)\n- [0.11.1](/ruby/docs/reference/google-cloud-bigquery-storage-v1/0.11.1/Google-Cloud-Bigquery-Storage-V1-CreateReadSessionRequest)\n- [0.10.1](/ruby/docs/reference/google-cloud-bigquery-storage-v1/0.10.1/Google-Cloud-Bigquery-Storage-V1-CreateReadSessionRequest)\n- [0.9.2](/ruby/docs/reference/google-cloud-bigquery-storage-v1/0.9.2/Google-Cloud-Bigquery-Storage-V1-CreateReadSessionRequest) \nReference documentation and code samples for the BigQuery Storage V1 API class Google::Cloud::Bigquery::Storage::V1::CreateReadSessionRequest.\n\nRequest message for `CreateReadSession`. \n\nInherits\n--------\n\n- Object \n\nExtended By\n-----------\n\n- Google::Protobuf::MessageExts::ClassMethods \n\nIncludes\n--------\n\n- Google::Protobuf::MessageExts\n\nMethods\n-------\n\n### #max_stream_count\n\n def max_stream_count() -\u003e ::Integer\n\n**Returns**\n\n- (::Integer) --- 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.\n\n This must be greater than or equal to preferred_min_stream_count.\n Typically, clients should either leave this unset to let the system to\n determine an upper bound OR set this a size for the maximum \"units of work\"\n it can gracefully handle.\n\n### #max_stream_count=\n\n def max_stream_count=(value) -\u003e ::Integer\n\n**Parameter**\n\n- **value** (::Integer) --- 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.\n\n\n This must be greater than or equal to preferred_min_stream_count.\n Typically, clients should either leave this unset to let the system to\n determine an upper bound OR set this a size for the maximum \"units of work\"\nit can gracefully handle. \n**Returns**\n\n- (::Integer) --- 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.\n\n This must be greater than or equal to preferred_min_stream_count.\n Typically, clients should either leave this unset to let the system to\n determine an upper bound OR set this a size for the maximum \"units of work\"\n it can gracefully handle.\n\n### #parent\n\n def parent() -\u003e ::String\n\n**Returns**\n\n- (::String) --- Required. The request project that owns the session, in the form of `projects/{project_id}`.\n\n### #parent=\n\n def parent=(value) -\u003e ::String\n\n**Parameter**\n\n- **value** (::String) --- Required. The request project that owns the session, in the form of `projects/{project_id}`. \n**Returns**\n\n- (::String) --- Required. The request project that owns the session, in the form of `projects/{project_id}`.\n\n### #preferred_min_stream_count\n\n def preferred_min_stream_count() -\u003e ::Integer\n\n**Returns**\n\n- (::Integer) --- 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).\n\n The system will make a best effort to provide at least this number of\n streams, but in some cases might provide less.\n\n### #preferred_min_stream_count=\n\n def preferred_min_stream_count=(value) -\u003e ::Integer\n\n**Parameter**\n\n- **value** (::Integer) --- 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).\n\n\n The system will make a best effort to provide at least this number of\nstreams, but in some cases might provide less. \n**Returns**\n\n- (::Integer) --- 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).\n\n The system will make a best effort to provide at least this number of\n streams, but in some cases might provide less.\n\n### #read_session\n\n def read_session() -\u003e ::Google::Cloud::Bigquery::Storage::V1::ReadSession\n\n**Returns**\n\n- ([::Google::Cloud::Bigquery::Storage::V1::ReadSession](./Google-Cloud-Bigquery-Storage-V1-ReadSession)) --- Required. Session to be created.\n\n### #read_session=\n\n def read_session=(value) -\u003e ::Google::Cloud::Bigquery::Storage::V1::ReadSession\n\n**Parameter**\n\n- **value** ([::Google::Cloud::Bigquery::Storage::V1::ReadSession](./Google-Cloud-Bigquery-Storage-V1-ReadSession)) --- Required. Session to be created. \n**Returns**\n\n- ([::Google::Cloud::Bigquery::Storage::V1::ReadSession](./Google-Cloud-Bigquery-Storage-V1-ReadSession)) --- Required. Session to be created."]]