Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add blog post on "How to Configure FerretDB to work on Percona Distribution for PostgreSQL" #2911

Merged
merged 10 commits into from
Jun 27, 2023

Conversation

Fashander
Copy link
Member

Description

Readiness checklist

  • I added/updated unit tests.
  • I added/updated integration/compatibility tests.
  • I added/updated comments and checked rendering.
  • I made spot refactorings.
  • I updated user documentation.
  • I ran task all, and it passed.
  • I ensured that PR title is good enough for the changelog.
  • (for maintainers only) I set Reviewers (@FerretDB/core), Labels, Project and project's Sprint fields.
  • I marked all done items in this checklist.

@Fashander Fashander added the blog/marketing Marketing (and releases) blog posts label Jun 26, 2023
@Fashander Fashander added this to the Next milestone Jun 26, 2023
@Fashander Fashander requested a review from AlekSi as a code owner June 26, 2023 12:01
@Fashander Fashander self-assigned this Jun 26, 2023
@Fashander Fashander requested a review from ptrfarkas as a code owner June 26, 2023 12:01
@Fashander Fashander added the trust PRs that can access Actions secrets label Jun 26, 2023
@mergify
Copy link
Contributor

mergify bot commented Jun 26, 2023

Marketing blog posts should be reviewed by @ptrfarkas and @AlekSi.

@codecov
Copy link

codecov bot commented Jun 26, 2023

Codecov Report

Merging #2911 (5b9cf93) into main (49d338c) will decrease coverage by 0.04%.
The diff coverage is n/a.

Additional details and impacted files

Impacted file tree graph

@@            Coverage Diff             @@
##             main    #2911      +/-   ##
==========================================
- Coverage   63.62%   63.58%   -0.04%     
==========================================
  Files         451      451              
  Lines       23583    23583              
==========================================
- Hits        15005    14996       -9     
- Misses       7610     7620      +10     
+ Partials      968      967       -1     

see 2 files with indirect coverage changes

Flag Coverage Δ
integration 56.89% <ø> (ø)
mongodb 4.39% <ø> (ø)
pg 56.81% <ø> (ø)
shard-1 41.99% <ø> (ø)
shard-2 45.15% <ø> (+<0.01%) ⬆️
shard-3 40.64% <ø> (ø)
unit 24.26% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

@Fashander Fashander changed the title Add blog post on "How to Configure FeerrPercona Distribution of PostgreSQL" Add blog post on "How to Configure FerretDB to work on Percona Distribution of PostgreSQL" Jun 26, 2023
@AlekSi AlekSi enabled auto-merge (squash) June 26, 2023 12:05
tags: [tutorial, postgresql tools]
---

![Meet FerretDB at Percona University in Casablanca and Belgrade](/img/blog/percona-ferretdb.png)
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't think this alt text is accurate


That's exactly what you get when you configure FerretDB for your Percona Distribution of PostgreSQL!

In this article, we'll guide you through the advantages of using FerretDB and how you can configure it to work natively on Percona Distribution of PostgreSQL and explore how FerretDB's commands appear in PostgreSQL, on Percona.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

WDYM "on Percona"?

Many software companies have built their applications on top of the database, extended its functionality, and provided robust infrastructures and services for it.
Percona is one of those companies, and have contributed immensely to the ecosystem with their array of PostgreSQL tools, extensions, and services.

A core part of the PostgreSQL Distribution provided by Percona is the Percona Server for PostgreSQL which is an enhanced version of the PostgreSQL DBMS itself, containing optimized features for better query performance, storage engine, and monitoring capabilities.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"Percona Server for PostgreSQL" is not a thing. There are exactly two pages where they mention it (1, 2), and both look like copies of Percona Server for MySQL (which is a thing) pages with bad editing.

There are multiple places like that.

`ferretdb` database should now be in context.
Let's proceed by setting `SET search_path TO ferretdb;` and then displaying the tables (this is akin to the collection we created earlier) in the database using `\dt`.

```sql
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Use `text` for the `psql` output and in other cases.

We can see two tables: one containing the metadata for the database and the other containing the `test` collection we created on Studio 3T.
Let's view the table content in PostgreSQL:

```sql
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Use `text` for the `psql` output and in other cases.

ferretdb=# table test_afd071e5;
```

```sh
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Use `text` for the `psql` output and in other cases.

…bution-postgresql.md

Co-authored-by: Alexey Palazhchenko <alexey.palazhchenko@gmail.com>
Fashander and others added 3 commits June 26, 2023 20:40
…bution-postgresql.md

Co-authored-by: Alexey Palazhchenko <alexey.palazhchenko@gmail.com>
…bution-postgresql.md

Co-authored-by: Alexey Palazhchenko <alexey.palazhchenko@gmail.com>
…bution-postgresql.md

Co-authored-by: Alexey Palazhchenko <alexey.palazhchenko@gmail.com>
@Fashander
Copy link
Member Author

@AlekSi @ptrfarkas PTAL

@AlekSi AlekSi changed the title Add blog post on "How to Configure FerretDB to work on Percona Distribution of PostgreSQL" Add blog post on "How to Configure FerretDB to work on Percona Distribution for PostgreSQL" Jun 27, 2023
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

That image uses a wrong product name

@AlekSi AlekSi disabled auto-merge June 27, 2023 05:33
@AlekSi AlekSi merged commit 9355acc into FerretDB:main Jun 27, 2023
@Fashander Fashander deleted the percona-ferretdb-blog branch December 4, 2023 08:15
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
blog/marketing Marketing (and releases) blog posts trust PRs that can access Actions secrets
Projects
Archived in project
Development

Successfully merging this pull request may close these issues.

2 participants