You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: src/connections/destinations/catalog/actions-singlestore/index.md
+16-16Lines changed: 16 additions & 16 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -27,19 +27,19 @@ This destination is maintained by SingleStore. For any issues with the destinati
27
27
{% include components/actions-fields.html %}
28
28
29
29
### Finding your SingleStore connection settings
30
-
To connect Segment to SingleStore, use the SingleStore Data API (typically on port 443). Follow these steps to enable and locate your Data API connection settings:
30
+
To connect Segment to SingleStore, use the SingleStore Data API (typically on port `443`). Follow these steps to enable and locate your Data API connection settings:
31
31
32
32
1. Head to the [SingleStore Portal](https://portal.singlestore.com){:target="_blank"}.
33
33
2. Select **Deployments**.
34
-
3. Choose your Workspace and Database within the list of Deployments
35
-
4. From the Connect dropdown, select **Connect to your own app**. SingleStore will display the the key settings you need to connect your SingleStore database to Segment.
34
+
3. Choose your **Workspace** and **Database** within the list of deployments
35
+
4. From the **Connect** dropdown, select **Connect to your own app**. SingleStore will display the the key settings you need to connect your SingleStore database to Segment.
36
36
37
-
**Note:**
37
+
**Note**:
38
38
- The Data API is enabled by default for all SingleStore Cloud workspaces.
39
-
- Segment always uses the Data API (typically on port 443).
40
-
- If you are using a self-hosted or development SingleStore deployment (such as the SingleStore-dev image), the Data API may run on a different port. Refer to your deployment’s documentation or settings to confirm the correct port.
39
+
- Segment always uses the Data API (typically on port `443`).
40
+
- If you use a self-hosted or development SingleStore deployment (such as the SingleStore-dev image), the Data API may run on a different port. Refer to your deployment’s documentation or settings to confirm the correct port.
41
41
42
-
For more details, see the [SingleStore Data API documentation](https://docs.singlestore.com/cloud/reference/data-api/){:target="_blank"}.
42
+
For more information, see the [SingleStore Data API documentation](https://docs.singlestore.com/cloud/reference/data-api/){:target="_blank"}.
43
43
44
44
## Database structure
45
45
Segment writes data to your specified table in SingleStore (by default, this is `segment_data`) using the following schema:
@@ -48,10 +48,10 @@ Segment writes data to your specified table in SingleStore (by default, this is
48
48
| -------- | ------ | ----------- |
49
49
|`messageId`| TEXT | A unique identifier for the event to ensure there is no duplication. |
50
50
|`timestamp`| Datetime(6) | The timestamp of when the event was generated |
51
-
|`type`| TEXT | The type of the event (e.g., "track", "identify", "page", "screen", "group", "alias"). |
52
-
|`event`| TEXT | The name of the event. Only required for "track" events. |
51
+
|`type`| TEXT | The type of the event (for example, Track, Identify, Page, Screen, Group, or Alias). |
52
+
|`event`| TEXT | The name of the event. Only required for Track events. |
53
53
|`name`| TEXT | The name of the page or screen. |
54
-
|`properties`| JSON | The properties of the track, page or screen event. |
54
+
|`properties`| JSON | The properties of the Track, Page or Screen event. |
55
55
|`userId`| TEXT | The user ID associated with the event. |
56
56
|`anonymousId`| TEXT | The anonymous ID associated with the event. |
57
57
|`groupId`| TEXT | The group ID associated with the event. |
@@ -71,17 +71,17 @@ This query allows you to extract specific nested properties from the JSON column
71
71
72
72
## Troubleshooting
73
73
74
-
> **Note:**
74
+
> info "
75
75
> The SingleStore Data API has a limit of 1MB per request. If a batch of events sent by Segment exceeds this limit, you may see an error similar to:
76
76
>
77
77
> ```
78
78
> Error reading request body: http: request body too large
79
79
> ```
80
80
>
81
-
> If you encounter this error, reduce the batch size in your Segment destination settings.
81
+
> If you encounter this error, reduce the batch size in your Segment destination settings."
82
82
83
83
84
-
### Connection Errors
84
+
### Connection errors
85
85
If you're unable to connect to the SingleStore database:
86
86
* Verify that the credentials are correct.
87
87
* Ensure that your SingleStore database is accessible from Segment’s servers.
@@ -92,20 +92,20 @@ If you encounter authentication errors when Segment attempts to connect:
92
92
* Confirm that the Username and Password are correct.
93
93
* Ensure that the user has the necessary permissions to write to the database.
94
94
95
-
### Data Not Appearing in SingleStore
95
+
### Data not appearing in SingleStore
96
96
If events are not recorded in the specified table:
97
97
* Verify that your sources are correctly sending data to Segment.
98
98
* Check the event types to ensure they are supported.
99
99
* Review your SingleStore database logs for any errors.
100
100
101
-
## Frequently Asked Questions
101
+
## Frequently asked questions
102
102
### Can I customize the schema used in SingleStore?
103
103
104
104
By default, the mapping stores all fields from the Segment event in separate columns in the `segment_data` table. If you prefer, you can customize the mapping to selectively include or exclude specific fields to be sent and written into SingleStore.
105
105
106
106
### How does SingleStore handle data types from Segment?
107
107
108
-
All event data is stored natively as JSON in the message column. This allows for flexible schema management and easy access to nested properties using SQL queries. SingleStore's ability to dynamically and quickly parse the JSON allows all types of complex events to be queried or used in notebooks.
108
+
Event data is stored as JSON in the message column. This allows for flexible schema management and easy access to nested properties using SQL queries. SingleStore's ability to dynamically and quickly parse the JSON allows all types of complex events to be queried or used in notebooks.
0 commit comments