- NAME
-
- gcloud beta dataproc sessions create spark - create a Spark session
- SYNOPSIS
-
-
gcloud beta dataproc sessions create spark
(SESSION
:--location
=LOCATION
) [--async
] [--container-image
=CONTAINER_IMAGE
] [--history-server-cluster
=HISTORY_SERVER_CLUSTER
] [--kernel
=KERNEL
] [--kms-key
=KMS_KEY
] [--labels
=[KEY
=VALUE
,…]] [--max-idle
=MAX_IDLE
] [--metastore-service
=METASTORE_SERVICE
] [--property
=[PROPERTY
=VALUE
,…]] [--request-id
=REQUEST_ID
] [--service-account
=SERVICE_ACCOUNT
] [--session_template
=SESSION_TEMPLATE
] [--staging-bucket
=STAGING_BUCKET
] [--tags
=[TAGS
,…]] [--ttl
=TTL
] [--version
=VERSION
] [--network
=NETWORK
|--subnet
=SUBNET
] [GCLOUD_WIDE_FLAG …
]
-
- DESCRIPTION
-
(BETA)
Create a Spark session. - EXAMPLES
-
To create a Spark session, to:
gcloud beta dataproc sessions create spark my-session --location=us-central1
- POSITIONAL ARGUMENTS
-
-
Session resource - ID of the session to create. The arguments in this group can
be used to specify the attributes of this resource. (NOTE) Some attributes are
not given arguments in this group but can be set in other ways.
To set the
project
attribute:-
provide the argument
session
on the command line with a fully specified name; -
provide the argument
--project
on the command line; -
set the property
core/project
.
This must be specified.
SESSION
-
ID of the session or fully qualified identifier for the session.
To set the
session
attribute:-
provide the argument
session
on the command line.
This positional argument must be specified if any of the other arguments in this group are specified.
-
provide the argument
--location
=LOCATION
-
Dataproc location for the session. Each Dataproc location constitutes an
independent resource namespace constrained to deploying instances into Compute
Engine zones inside the location. Overrides the default
dataproc/location
property value for this command invocation.To set the
location
attribute:-
provide the argument
session
on the command line with a fully specified name; -
provide the argument
--location
on the command line; -
set the property
dataproc/location
.
-
provide the argument
-
provide the argument
-
Session resource - ID of the session to create. The arguments in this group can
be used to specify the attributes of this resource. (NOTE) Some attributes are
not given arguments in this group but can be set in other ways.
- FLAGS
-
--async
- Return immediately without waiting for the operation in progress to complete.
--container-image
=CONTAINER_IMAGE
- Optional custom container image to use for the batch/session runtime environment. If not specified, a default container image will be used. The value should follow the container image naming format: {registry}/{repository}/{name}:{tag}, for example, gcr.io/my-project/my-image:1.2.3
--history-server-cluster
=HISTORY_SERVER_CLUSTER
- Spark History Server configuration for the batch/session job. Resource name of an existing Dataproc cluster to act as a Spark History Server for the workload in the format: "projects/{project_id}/regions/{region}/clusters/{cluster_name}".
--kernel
=KERNEL
-
Jupyter kernel type. The value could be "python" or "scala".
KERNEL
must be one of:python
,scala
. --kms-key
=KMS_KEY
- Cloud KMS key to use for encryption.
--labels
=[KEY
=VALUE
,…]-
List of label KEY=VALUE pairs to add.
Keys must start with a lowercase character and contain only hyphens (
-
), underscores (_
), lowercase characters, and numbers. Values must contain only hyphens (-
), underscores (_
), lowercase characters, and numbers. --max-idle
=MAX_IDLE
- The duration after which an idle session will be automatically terminated, for example, "20m" or "2h". A session is considered idle if it has no active Spark applications and no active Jupyter kernels. Run gcloud topic datetimes for information on duration formats.
--metastore-service
=METASTORE_SERVICE
- Name of a Dataproc Metastore service to be used as an external metastore in the format: "projects/{project-id}/locations/{region}/services/{service-name}".
--property
=[PROPERTY
=VALUE
,…]- Specifies configuration properties.
--request-id
=REQUEST_ID
-
A unique ID that identifies the request. If the service receives two session
create requests with the same request_id, the second request is ignored and the
operation that corresponds to the first session created and stored in the
backend is returned. Recommendation: Always set this value to a UUID. The value
must contain only letters (a-z, A-Z), numbers (0-9), underscores (
), and hyphens (-). The maximum length is 40 characters.
--service-account
=SERVICE_ACCOUNT- The IAM service account to be used for a batch/session job.
--session_template
=SESSION_TEMPLATE- The session template to use for creating the session.
--staging-bucket
=STAGING_BUCKET- The Cloud Storage bucket to use to store job dependencies, config files, and job driver console output. If not specified, the default [staging bucket] (https://cloud.google.com/dataproc-serverless/docs/concepts/buckets) is used.
- Network tags for traffic control.
--ttl
=TTL- The duration after the workload will be unconditionally terminated, for example, '20m' or '1h'. Run gcloud topic datetimes for information on duration formats.
--version
=VERSION- Optional runtime version. If not specified, a default version will be used.
-
At most one of these can be specified:
--network
=NETWORK- Network URI to connect network to.
--subnet
=SUBNET- Subnetwork URI to connect network to. Subnet must have Private Google Access enabled.
- GCLOUD WIDE FLAGS
-
These flags are available to all commands:
--access-token-file
,--account
,--billing-project
,--configuration
,--flags-file
,--flatten
,--format
,--help
,--impersonate-service-account
,--log-http
,--project
,--quiet
,--trace-token
,--user-output-enabled
,--verbosity
.Run
$ gcloud help
for details. - NOTES
- This command is currently in beta and might change without notice.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-08-28 UTC.