Skip to content

Commit 0166c78

Browse files
committed
Resolving script issues and old keys
1 parent cfb2b35 commit 0166c78

File tree

3 files changed

+17
-18
lines changed

3 files changed

+17
-18
lines changed

articles/synapse-analytics/sql/create-external-table-as-select.md

Lines changed: 14 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ author: vvasic-msft
55
ms.service: azure-synapse-analytics
66
ms.topic: overview
77
ms.subservice: sql
8-
ms.date: 04/15/2020
8+
ms.date: 02/20/2025
99
ms.author: vvasic
1010
ms.reviewer: whhender
1111
---
@@ -16,28 +16,31 @@ In this article, you'll learn how to store query results to storage using server
1616

1717
## Prerequisites
1818

19-
Your first step is to **create a database** where you will execute the queries. Then initialize the objects by executing [setup script](https://github.com/Azure-Samples/Synapse/blob/master/SQL/Samples/LdwSample/SampleDB.sql) on that database. This setup script will create the data sources, database scoped credentials, and external file formats that are used to read data in these samples.
19+
Your first step is to **create a database** where you'll execute the queries. Then initialize the objects by executing [setup script](https://github.com/Azure-Samples/Synapse/blob/master/SQL/Samples/LdwSample/SampleDB.sql) on that database. This setup script will create the data sources, database scoped credentials, and external file formats that are used to read data in these samples.
2020

2121
Follow the instructions in this article to create data sources, database scoped credentials, and external file formats that are used to write data into the output storage.
2222

2323
## Create external table as select
2424

25-
You can use the CREATE EXTERNAL TABLE AS SELECT (CETAS) statement to store the query results to storage.
25+
You can use the CREATE EXTERNAL TABLE AS SELECT (CETAS) statement to store the query results to storage.
2626

2727
> [!NOTE]
28-
> Change the first line in the query, i.e., [mydbname], so you're using the database you created.
28+
> Change these values in the query to reflect your environment:
29+
> - mydbname - change it to the name of the database you created
30+
> - storage-account-sas - the [shared access signature](/azure/ai-services/document-intelligence/authentication/create-sas-tokens#generating-sas-tokens) for a storage account where you want to write your results
31+
> - your-storage-account-name - the name of your storage account where you want to write your results (Make sure you have a container called 'csv' or that you change the name of the container here also)
2932
3033
```sql
3134
USE [mydbname];
3235
GO
3336

3437
CREATE DATABASE SCOPED CREDENTIAL [SasTokenWrite]
3538
WITH IDENTITY = 'SHARED ACCESS SIGNATURE',
36-
SECRET = 'sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-04-18T20:42:12Z&st=2019-04-18T12:42:12Z&spr=https&sig=lQHczNvrk1KoYLCpFdSsMANd0ef9BrIPBNJ3VYEIq78%3D';
39+
SECRET = 'storage-account-sas';
3740
GO
3841

3942
CREATE EXTERNAL DATA SOURCE [MyDataSource] WITH (
40-
LOCATION = 'https://<storage account name>.blob.core.windows.net/csv', CREDENTIAL = [SasTokenWrite]
43+
LOCATION = 'https://your-storage-account-name.blob.core.windows.net/csv', CREDENTIAL = [SasTokenWrite]
4144
);
4245
GO
4346

@@ -69,14 +72,14 @@ FROM
6972
```
7073

7174
> [!NOTE]
72-
> You must modify this script and change the target location to execute it again. External tables cannot be created on the location where you already have some data.
75+
> You must modify this script and change the target location to execute it again. External tables can't be created on the location where you already have some data.
7376
7477
## Use the external table
7578

7679
You can use the external table created through CETAS like a regular external table.
7780

7881
> [!NOTE]
79-
> Change the first line in the query, i.e., [mydbname], so you're using the database you created.
82+
> Change the first line in the query, that is, [mydbname], so you're using the database you created.
8083
8184
```sql
8285
USE [mydbname];
@@ -93,14 +96,10 @@ ORDER BY
9396

9497
## Remarks
9598

96-
Once you store your results, the data in the external table cannot be modified. You cannot repeat this script because CETAS will not overwrite the underlying data created in the previous execution. Vote for the following feedback items if some of these are required in your scenarios, or propose the new ones on Azure feedback site:
97-
- [Enable inserting new data into external table](https://feedback.azure.com/d365community/forum/9b9ba8e4-0825-ec11-b6e6-000d3a4f07b8)
98-
- [Enable deleting data from external table](https://feedback.azure.com/d365community/idea/fb5a00c9-0a25-ec11-b6e6-000d3a4f07b8)
99-
- [Specify partitions in CETAS](https://feedback.azure.com/d365community/idea/e28278db-0a25-ec11-b6e6-000d3a4f07b8)
100-
- [Specify file sizes and counts](https://feedback.azure.com/d365community/idea/262048b9-0925-ec11-b6e6-000d3a4f07b8)
99+
Once you store your results, the data in the external table can't be modified. You can't repeat this script because CETAS won't overwrite the underlying data created in the previous execution.
101100

102-
The only supported output types are Parquet and CSV. You can vote for the other types on [Azure feedback site](https://feedback.azure.com/d365community/forum/9b9ba8e4-0825-ec11-b6e6-000d3a4f07b8).
101+
The only supported output types are currently Parquet and CSV.
103102

104-
## Next steps
103+
## Related content
105104

106105
For more information on how to query different file types, see the [Query single CSV file](query-single-csv-file.md), [Query Parquet files](query-parquet-files.md), and [Query JSON files](query-json-files.md) articles.

articles/synapse-analytics/sql/create-use-external-tables.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -41,7 +41,7 @@ Your first step is to create a database where the tables will be created. Before
4141
```sql
4242
CREATE DATABASE SCOPED CREDENTIAL [sqlondemand]
4343
WITH IDENTITY='SHARED ACCESS SIGNATURE',
44-
SECRET = 'sv=2018-03-28&ss=bf&srt=sco&sp=rl&st=2019-10-14T12%3A10%3A25Z&se=2061-12-31T12%3A10%3A00Z&sig=KlSU2ullCscyTS0An0nozEpo4tO5JAgGBvw%2FJX2lguw%3D'
44+
SECRET = 'sv=2022-11-02&ss=b&srt=co&sp=rl&se=2042-11-26T17:40:55Z&st=2024-11-24T09:40:55Z&spr=https&sig=DKZDuSeZhuCWP9IytWLQwu9shcI5pTJ%2Fw5Crw6fD%2BC8%3D'
4545
```
4646

4747
- EXTERNAL DATA SOURCE `sqlondemanddemo` that references demo storage account protected with SAS key, and EXTERNAL DATA SOURCE `nyctlc` that references publicly available Azure storage account on location `https://azureopendatastorage.blob.core.windows.net/nyctlc/`.

articles/synapse-analytics/sql/develop-tables-external-tables.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -84,7 +84,7 @@ The following example creates a Hadoop external data source in dedicated SQL poo
8484
```sql
8585
CREATE DATABASE SCOPED CREDENTIAL [ADLS_credential]
8686
WITH IDENTITY='SHARED ACCESS SIGNATURE',
87-
SECRET = 'sv=2018-03-28&ss=bf&srt=sco&sp=rl&st=2019-10-14T12%3A10%3A25Z&se=2061-12-31T12%3A10%3A00Z&sig=KlSU2ullCscyTS0An0nozEpo4tO5JAgGBvw%2FJX2lguw%3D'
87+
SECRET = 'sv=2022-11-02&ss=b&srt=co&sp=rl&se=2042-11-26T17:40:55Z&st=2024-11-24T09:40:55Z&spr=https&sig=DKZDuSeZhuCWP9IytWLQwu9shcI5pTJ%2Fw5Crw6fD%2BC8%3D'
8888
GO
8989
CREATE EXTERNAL DATA SOURCE AzureDataLakeStore
9090
WITH
@@ -110,7 +110,7 @@ The following example creates an external data source in serverless or dedicated
110110
```sql
111111
CREATE DATABASE SCOPED CREDENTIAL [sqlondemand]
112112
WITH IDENTITY='SHARED ACCESS SIGNATURE',
113-
SECRET = 'sv=2018-03-28&ss=bf&srt=sco&sp=rl&st=2019-10-14T12%3A10%3A25Z&se=2061-12-31T12%3A10%3A00Z&sig=KlSU2ullCscyTS0An0nozEpo4tO5JAgGBvw%2FJX2lguw%3D'
113+
SECRET = 'sv=2022-11-02&ss=b&srt=co&sp=rl&se=2042-11-26T17:40:55Z&st=2024-11-24T09:40:55Z&spr=https&sig=DKZDuSeZhuCWP9IytWLQwu9shcI5pTJ%2Fw5Crw6fD%2BC8%3D'
114114
GO
115115
CREATE EXTERNAL DATA SOURCE SqlOnDemandDemo WITH (
116116
LOCATION = 'https://sqlondemandstorage.blob.core.windows.net',

0 commit comments

Comments
 (0)