Skip to content

Commit 06ab6a3

Browse files
committed
Establish prereqs of quickstarts
1 parent bb1dc09 commit 06ab6a3

File tree

3 files changed

+29
-11
lines changed

3 files changed

+29
-11
lines changed

articles/postgresql/hyperscale/quickstart-connect-psql.md

Lines changed: 9 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,14 @@ ms.date: 01/24/2022
1212

1313
# Connect to a Hyperscale (Citus) server group with psql
1414

15+
## Prerequisites
16+
17+
To follow this quickstart, you'll first need to:
18+
19+
* [Create a server group](quickstart-create-portal.md) in the Azure portal.
20+
21+
## Connect
22+
1523
When you create your Azure Database for PostgreSQL server, a default database named **citus** is created. To connect to your database server, you need a connection string and the admin password.
1624

1725
1. Obtain the connection string. In the server group page click the **Connection strings** menu item. (It's under **Settings**.) Find the string marked **psql**. It will be of the form:
@@ -35,7 +43,7 @@ When you create your Azure Database for PostgreSQL server, a default database na
3543
psql "host=mydemoserver-c.postgres.database.azure.com port=5432 dbname=citus user=citus password={your_password} sslmode=require"
3644
```
3745

38-
**Next steps**
46+
## Next steps
3947

4048
* [Troubleshoot connection problems](howto-troubleshoot-common-connection-issues.md).
4149
* Learn to [create and distribute tables](quickstart-distribute-tables.md).

articles/postgresql/hyperscale/quickstart-distribute-tables.md

Lines changed: 8 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -12,8 +12,6 @@ ms.date: 01/24/2022
1212

1313
# Create and distribute tables
1414

15-
Once connected to the hyperscale coordinator node using psql, you can complete some basic tasks.
16-
1715
Within Hyperscale (Citus) servers there are three types of tables:
1816

1917
* **Distributed Tables** - Distributed across worker nodes (scaled out).
@@ -29,6 +27,14 @@ familiar with them.
2927

3028
The data model we're going to work with is simple: user and event data from GitHub. Events include fork creation, git commits related to an organization, and more.
3129

30+
## Prerequisites
31+
32+
To follow this quickstart, you'll first need to:
33+
34+
1. [Create a server group](quickstart-create-portal.md) in the Azure portal.
35+
2. [Connect to the server group](quickstart-connect-psql.md) with psql to
36+
run SQL commands.
37+
3238
## Create tables
3339

3440
Once you've connected via psql, let's create our tables. In the psql console run:

articles/postgresql/hyperscale/quickstart-run-queries.md

Lines changed: 12 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -7,17 +7,25 @@ ms.service: postgresql
77
ms.subservice: hyperscale-citus
88
ms.custom: mvc, mode-ui
99
ms.topic: quickstart
10-
ms.date: 01/19/2022
10+
ms.date: 01/24/2022
1111
---
1212

1313
# Run queries
1414

15-
After [creating and distributing data](quickstart-distribute-tables.md), we can
16-
now run queries that execute in parallel across worker nodes.
15+
## Prerequisites
16+
17+
To follow this quickstart, you'll first need to:
18+
19+
1. [Create a server group](quickstart-create-portal.md) in the Azure portal.
20+
2. [Connect to the server group](quickstart-connect-psql.md) with psql to
21+
run SQL commands.
22+
3. [Create and distribute tables](quickstart-distribute-tables.md) with our
23+
example dataset.
1724

1825
## Aggregate queries
1926

20-
Let's start with a simple `count (*)` to see how much data we loaded:
27+
Now it's time for the fun part in our quickstart series: actually running some
28+
queries. Let's start with a simple `count (*)` to see how much data we loaded:
2129

2230
```sql
2331
SELECT count(*) from github_events;
@@ -49,10 +57,6 @@ SELECT gu.login, count(*)
4957
ORDER BY count(*) DESC;
5058
```
5159

52-
## Clean up resources
53-
54-
If you don't expect to need these resources in the future, delete the server group. Press the **Delete** button in the **Overview** page for your server group. When prompted on a pop-up page, confirm the name of the server group and click the final **Delete** button.
55-
5660
## Next steps
5761

5862
- Follow a tutorial to [build scalable multi-tenant

0 commit comments

Comments
 (0)