Create and manage Astra Streaming tenants, namespaces, and topic
This page summarizes how to create, view, edit, and delete Astra Streaming streaming tenants, namespaces, and topics. The primary actions can be performed programmatically and in the Astra Portal. However, some details are available in the Astra Portal only.
|
If you’re new to Astra Streaming, try the Astra Streaming quickstart to learn about creating tenants, namespaces, and topics. |
Create a tenant
-
Astra Portal
-
API
-
CLI
-
In the Astra Portal header, click Applications, and then select Streaming.
-
Click Create tenant.
-
Enter a name for the streaming tenant.
-
Select a cloud provider and region that supports Astra Streaming.
Not all Astra DB regions support Astra Streaming. If your preferred region isn’t available, contact your DataStax account representative or DataStax Support.
-
Click Create tenant.
View and edit a tenant, namespace, or topic
After you create a tenant, you can inspect the tenant, create and manage namespaces and topics, and configure tenant settings.
Get tenant information
-
Astra Portal
-
API
-
CLI
-
In the Astra Portal header, click Applications, and then select Streaming.
-
Click the name of your tenant.
-
Click any of the tabs to access tenant information and settings, such as Connect or Sinks.
Use astra streaming get.
Manage namespaces
-
Astra Portal
-
API
-
In the Astra Portal header, click Applications, and then select Streaming.
-
Click the name of your tenant, and then click the Namespace And Topics tab to manage namespaces:
-
Create a namespace: Click Create Namespace, enter a namespace name, and then click Create Namespace.
-
Configure replication: See Geo-replication.
-
Delete a namespace: Find the namespace you want to delete, click Modify Namespace, find the Delete This Namespace section, and then click Delete Namespace.
-
Return to all namespaces: When modifying an individual namespace, click Back to Namespaces to return to the list of all namespaces in the current tenant.
-
Manage topics
-
Astra Portal
-
API
-
In the Astra Portal header, click Applications, and then select Streaming.
-
Click the name of your tenant, and then click the Namespace And Topics tab to manage topics:
-
Create a topic: Find the namespace where you want to create the topic, click Add Topic, enter a topic name, and then click Add Topic.
-
Inspect and configure a topic: Click Expand to view the list of topics in a specific namespace, click the name of the topic you want to manage, and then use the tabs to access the topic’s information and settings, such as Subscriptions and Consumers.
-
Delete a topic: Click Expand to view the list of topics in a specific namespace, find the topic you want to delete, click More, and then select Delete Topic.
-
Terminate a tenant
|
Terminating a tenant is a destructive operation that permanently deletes the tenant and all associated sinks, topics, messages, and namespaces. |
-
Astra Portal
-
API
-
CLI
-
In the Astra Portal header, click Applications, and then select Streaming.
-
Find the tenant that you want to delete, click More, and then select Terminate.
