Stay organized with collections
Save and categorize content based on your preferences.
Deletes the dataset specified by the datasetId value. Before you can
delete a dataset, you must delete all its tables, either manually or by
specifying deleteContents. Immediately after deletion, you can create
another dataset with the same name.
Arguments
Parameters
datasetId
string
Required. Dataset ID of dataset being deleted
projectId
string
Required. Project ID of the dataset being deleted
deleteContents
boolean
If True, delete all the tables in the dataset. If False and the dataset contains tables, the request will fail. Default is False
Raised exceptions
Exceptions
ConnectionError
In case of a network problem (such as DNS failure or refused connection).
HttpError
If the response status is >= 400 (excluding 429 and 503).
TimeoutError
If a long-running operation takes longer to finish than the specified timeout limit.
TypeError
If an operation or function receives an argument of the wrong type.
ValueError
If an operation or function receives an argument of the right type but an inappropriate value. For example, a negative timeout.
Response
If successful, the response will be empty.
Subworkflow snippet
Some fields might be optional or required.
To identify required fields, refer to the API documentation.
[[["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-04 UTC."],[],[],null,["# Method: googleapis.bigquery.v2.datasets.delete\n\nDeletes the dataset specified by the datasetId value. Before you can\ndelete a dataset, you must delete all its tables, either manually or by\nspecifying deleteContents. Immediately after deletion, you can create\nanother dataset with the same name.\n\nArguments\n---------\n\nRaised exceptions\n-----------------\n\nResponse\n--------\n\nIf successful, the response will be empty.\n\nSubworkflow snippet\n-------------------\n\nSome fields might be optional or required.\nTo identify required fields, refer to the [API documentation](https://cloud.google.com/bigquery/docs/reference/rest/v2/datasets/delete). \n\n### YAML\n\n```yaml\n- delete:\n call: googleapis.bigquery.v2.datasets.delete\n args:\n datasetId: ...\n projectId: ...\n deleteContents: ...\n result: deleteResult\n```\n\n### JSON\n\n```json\n[\n {\n \"delete\": {\n \"call\": \"googleapis.bigquery.v2.datasets.delete\",\n \"args\": {\n \"datasetId\": \"...\",\n \"projectId\": \"...\",\n \"deleteContents\": \"...\"\n },\n \"result\": \"deleteResult\"\n }\n }\n]\n```"]]