Required. String of the form projects/{project_id} indicating the
project this ReadSession is associated with. This is the project that will
be billed for usage.
Required. String of the form projects/{project_id} indicating the
project this ReadSession is associated with. This is the project that will
be billed for usage.
Initial number of streams. If unset or 0, we 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 and
the maximum amount of parallelism allowed by the system.
[[["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-08-18 UTC."],[],[],null,["# Interface Storage.CreateReadSessionRequestOrBuilder (3.16.2)\n\nVersion latestkeyboard_arrow_down\n\n- [3.16.2 (latest)](/java/docs/reference/google-cloud-bigquerystorage/latest/com.google.cloud.bigquery.storage.v1beta1.Storage.CreateReadSessionRequestOrBuilder)\n- [3.16.1](/java/docs/reference/google-cloud-bigquerystorage/3.16.1/com.google.cloud.bigquery.storage.v1beta1.Storage.CreateReadSessionRequestOrBuilder)\n- [3.15.3](/java/docs/reference/google-cloud-bigquerystorage/3.15.3/com.google.cloud.bigquery.storage.v1beta1.Storage.CreateReadSessionRequestOrBuilder)\n- [3.14.1](/java/docs/reference/google-cloud-bigquerystorage/3.14.1/com.google.cloud.bigquery.storage.v1beta1.Storage.CreateReadSessionRequestOrBuilder)\n- [3.12.0](/java/docs/reference/google-cloud-bigquerystorage/3.12.0/com.google.cloud.bigquery.storage.v1beta1.Storage.CreateReadSessionRequestOrBuilder)\n- [3.11.4](/java/docs/reference/google-cloud-bigquerystorage/3.11.4/com.google.cloud.bigquery.storage.v1beta1.Storage.CreateReadSessionRequestOrBuilder)\n- [3.10.3](/java/docs/reference/google-cloud-bigquerystorage/3.10.3/com.google.cloud.bigquery.storage.v1beta1.Storage.CreateReadSessionRequestOrBuilder)\n- [3.9.3](/java/docs/reference/google-cloud-bigquerystorage/3.9.3/com.google.cloud.bigquery.storage.v1beta1.Storage.CreateReadSessionRequestOrBuilder)\n- [3.8.0](/java/docs/reference/google-cloud-bigquerystorage/3.8.0/com.google.cloud.bigquery.storage.v1beta1.Storage.CreateReadSessionRequestOrBuilder)\n- [3.6.1](/java/docs/reference/google-cloud-bigquerystorage/3.6.1/com.google.cloud.bigquery.storage.v1beta1.Storage.CreateReadSessionRequestOrBuilder)\n- [3.5.2](/java/docs/reference/google-cloud-bigquerystorage/3.5.2/com.google.cloud.bigquery.storage.v1beta1.Storage.CreateReadSessionRequestOrBuilder)\n- [3.4.0](/java/docs/reference/google-cloud-bigquerystorage/3.4.0/com.google.cloud.bigquery.storage.v1beta1.Storage.CreateReadSessionRequestOrBuilder)\n- [3.3.1](/java/docs/reference/google-cloud-bigquerystorage/3.3.1/com.google.cloud.bigquery.storage.v1beta1.Storage.CreateReadSessionRequestOrBuilder)\n- [3.2.0](/java/docs/reference/google-cloud-bigquerystorage/3.2.0/com.google.cloud.bigquery.storage.v1beta1.Storage.CreateReadSessionRequestOrBuilder)\n- [3.1.0](/java/docs/reference/google-cloud-bigquerystorage/3.1.0/com.google.cloud.bigquery.storage.v1beta1.Storage.CreateReadSessionRequestOrBuilder)\n- [3.0.1](/java/docs/reference/google-cloud-bigquerystorage/3.0.1/com.google.cloud.bigquery.storage.v1beta1.Storage.CreateReadSessionRequestOrBuilder)\n- [2.47.0](/java/docs/reference/google-cloud-bigquerystorage/2.47.0/com.google.cloud.bigquery.storage.v1beta1.Storage.CreateReadSessionRequestOrBuilder)\n- [2.45.0](/java/docs/reference/google-cloud-bigquerystorage/2.45.0/com.google.cloud.bigquery.storage.v1beta1.Storage.CreateReadSessionRequestOrBuilder)\n- [2.44.1](/java/docs/reference/google-cloud-bigquerystorage/2.44.1/com.google.cloud.bigquery.storage.v1beta1.Storage.CreateReadSessionRequestOrBuilder)\n- [2.43.0](/java/docs/reference/google-cloud-bigquerystorage/2.43.0/com.google.cloud.bigquery.storage.v1beta1.Storage.CreateReadSessionRequestOrBuilder) \n\n public static interface Storage.CreateReadSessionRequestOrBuilder extends MessageOrBuilder\n\nImplements\n----------\n\n[MessageOrBuilder](https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.MessageOrBuilder.html)\n\nMethods\n-------\n\n### getFormat()\n\n public abstract Storage.DataFormat getFormat()\n\nData output format. Currently default to Avro.\nDATA_FORMAT_UNSPECIFIED not supported.\n\n`.google.cloud.bigquery.storage.v1beta1.DataFormat format = 5;`\n\n### getFormatValue()\n\n public abstract int getFormatValue()\n\nData output format. Currently default to Avro.\nDATA_FORMAT_UNSPECIFIED not supported.\n\n`.google.cloud.bigquery.storage.v1beta1.DataFormat format = 5;`\n\n### getParent()\n\n public abstract String getParent()\n\nRequired. String of the form `projects/{project_id}` indicating the\nproject this ReadSession is associated with. This is the project that will\nbe billed for usage.\n\n`\nstring parent = 6 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { ... }\n`\n\n### getParentBytes()\n\n public abstract ByteString getParentBytes()\n\nRequired. String of the form `projects/{project_id}` indicating the\nproject this ReadSession is associated with. This is the project that will\nbe billed for usage.\n\n`\nstring parent = 6 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { ... }\n`\n\n### getReadOptions()\n\n public abstract ReadOptions.TableReadOptions getReadOptions()\n\nRead options for this session (e.g. column selection, filters).\n\n`.google.cloud.bigquery.storage.v1beta1.TableReadOptions read_options = 4;`\n\n### getReadOptionsOrBuilder()\n\n public abstract ReadOptions.TableReadOptionsOrBuilder getReadOptionsOrBuilder()\n\nRead options for this session (e.g. column selection, filters).\n\n`.google.cloud.bigquery.storage.v1beta1.TableReadOptions read_options = 4;`\n\n### getRequestedStreams()\n\n public abstract int getRequestedStreams()\n\nInitial number of streams. If unset or 0, we will\nprovide a value of streams so as to produce reasonable throughput. Must be\nnon-negative. The number of streams may be lower than the requested number,\ndepending on the amount parallelism that is reasonable for the table and\nthe maximum amount of parallelism allowed by the system.\n\nStreams must be read starting from offset 0.\n\n`int32 requested_streams = 3;`\n\n### getShardingStrategy()\n\n public abstract Storage.ShardingStrategy getShardingStrategy()\n\nThe strategy to use for distributing data among multiple streams. Currently\ndefaults to liquid sharding.\n\n`.google.cloud.bigquery.storage.v1beta1.ShardingStrategy sharding_strategy = 7;`\n\n### getShardingStrategyValue()\n\n public abstract int getShardingStrategyValue()\n\nThe strategy to use for distributing data among multiple streams. Currently\ndefaults to liquid sharding.\n\n`.google.cloud.bigquery.storage.v1beta1.ShardingStrategy sharding_strategy = 7;`\n\n### getTableModifiers()\n\n public abstract TableReferenceProto.TableModifiers getTableModifiers()\n\nAny modifiers to the Table (e.g. snapshot timestamp).\n\n`.google.cloud.bigquery.storage.v1beta1.TableModifiers table_modifiers = 2;`\n\n### getTableModifiersOrBuilder()\n\n public abstract TableReferenceProto.TableModifiersOrBuilder getTableModifiersOrBuilder()\n\nAny modifiers to the Table (e.g. snapshot timestamp).\n\n`.google.cloud.bigquery.storage.v1beta1.TableModifiers table_modifiers = 2;`\n\n### getTableReference()\n\n public abstract TableReferenceProto.TableReference getTableReference()\n\nRequired. Reference to the table to read.\n\n`\n.google.cloud.bigquery.storage.v1beta1.TableReference table_reference = 1 [(.google.api.field_behavior) = REQUIRED];\n`\n\n### getTableReferenceOrBuilder()\n\n public abstract TableReferenceProto.TableReferenceOrBuilder getTableReferenceOrBuilder()\n\nRequired. Reference to the table to read.\n\n`\n.google.cloud.bigquery.storage.v1beta1.TableReference table_reference = 1 [(.google.api.field_behavior) = REQUIRED];\n`\n\n### hasReadOptions()\n\n public abstract boolean hasReadOptions()\n\nRead options for this session (e.g. column selection, filters).\n\n`.google.cloud.bigquery.storage.v1beta1.TableReadOptions read_options = 4;`\n\n### hasTableModifiers()\n\n public abstract boolean hasTableModifiers()\n\nAny modifiers to the Table (e.g. snapshot timestamp).\n\n`.google.cloud.bigquery.storage.v1beta1.TableModifiers table_modifiers = 2;`\n\n### hasTableReference()\n\n public abstract boolean hasTableReference()\n\nRequired. Reference to the table to read.\n\n`\n.google.cloud.bigquery.storage.v1beta1.TableReference table_reference = 1 [(.google.api.field_behavior) = REQUIRED];\n`"]]