Files
supabase/apps/studio/components/interfaces/Settings/Database/DatabaseSettings/DatabaseConnectionString.tsx
Joshen Lim 271734eec2 Chore/support checking replication lag in database reports (#26290)
* Init replication lag chart in database reports

* Navigate to replication lag chart via query params

* Add view replication lag CTA in map view

* Add replication lag metric to instance node view

* Prettier
2024-05-14 20:00:20 +08:00

353 lines
14 KiB
TypeScript

import * as Tooltip from '@radix-ui/react-tooltip'
import { useParams, useTelemetryProps } from 'common'
import { useRouter } from 'next/router'
import { useEffect, useRef, useState } from 'react'
import {
Button,
CollapsibleContent_Shadcn_,
CollapsibleTrigger_Shadcn_,
Collapsible_Shadcn_,
Input,
Separator,
Tabs,
cn,
} from 'ui'
import { useProjectContext } from 'components/layouts/ProjectLayout/ProjectContext'
import AlertError from 'components/ui/AlertError'
import DatabaseSelector from 'components/ui/DatabaseSelector'
import Panel from 'components/ui/Panel'
import ShimmeringLoader from 'components/ui/ShimmeringLoader'
import { useProjectSettingsQuery } from 'data/config/project-settings-query'
import { usePoolingConfigurationQuery } from 'data/database/pooling-configuration-query'
import { useReadReplicasQuery } from 'data/read-replicas/replicas-query'
import { pluckObjectFields } from 'lib/helpers'
import Telemetry from 'lib/telemetry'
import { useDatabaseSelectorStateSnapshot } from 'state/database-selector'
import { useDatabaseSettingsStateSnapshot } from 'state/database-settings'
import { IPv4DeprecationNotice } from '../IPv4DeprecationNotice'
import { UsePoolerCheckbox } from '../UsePoolerCheckbox'
import {
constructConnStringSyntax,
getConnectionStrings,
getPoolerTld,
} from './DatabaseSettings.utils'
import { ChevronDown, ExternalLink } from 'lucide-react'
const CONNECTION_TYPES = [
{ id: 'uri', label: 'URI' },
{ id: 'psql', label: 'PSQL' },
{ id: 'golang', label: 'Golang' },
{ id: 'jdbc', label: 'JDBC' },
{ id: 'dotnet', label: '.NET' },
{ id: 'nodejs', label: 'Nodejs' },
{ id: 'php', label: 'PHP' },
{ id: 'python', label: 'Python' },
]
interface DatabaseConnectionStringProps {
appearance: 'default' | 'minimal'
}
export const DatabaseConnectionString = ({ appearance }: DatabaseConnectionStringProps) => {
const router = useRouter()
const telemetryProps = useTelemetryProps()
const { ref: projectRef, connectionString } = useParams()
const snap = useDatabaseSettingsStateSnapshot()
const state = useDatabaseSelectorStateSnapshot()
const { project: projectDetails, isLoading: isProjectLoading } = useProjectContext()
const readReplicasEnabled = projectDetails?.is_read_replicas_enabled
const connectionStringsRef = useRef<HTMLDivElement>(null)
const [poolingMode, setPoolingMode] = useState<'transaction' | 'session' | 'statement'>('session')
const [selectedTab, setSelectedTab] = useState<
'uri' | 'psql' | 'golang' | 'jdbc' | 'dotnet' | 'nodejs' | 'php' | 'python'
>('uri')
const { data: poolingInfo, isSuccess: isSuccessPoolingInfo } = usePoolingConfigurationQuery({
projectRef,
})
const poolingConfiguration = readReplicasEnabled
? poolingInfo?.find((x) => x.identifier === state.selectedDatabaseId)
: poolingInfo?.find((x) => x.database_type === 'PRIMARY')
const {
data,
error: projectSettingsError,
isLoading: isLoadingProjectSettings,
isError: isErrorProjectSettings,
isSuccess: isSuccessProjectSettings,
} = useProjectSettingsQuery({ projectRef })
const {
data: databases,
error: readReplicasError,
isLoading: isLoadingReadReplicas,
isError: isErrorReadReplicas,
isSuccess: isSuccessReadReplicas,
} = useReadReplicasQuery({ projectRef })
const error = readReplicasEnabled ? readReplicasError : projectSettingsError
const isLoading = readReplicasEnabled ? isLoadingReadReplicas : isLoadingProjectSettings
const isError = readReplicasEnabled ? isErrorReadReplicas : isErrorProjectSettings
const isSuccess = readReplicasEnabled ? isSuccessReadReplicas : isSuccessProjectSettings
const selectedDatabase = (databases ?? []).find(
(db) => db.identifier === state.selectedDatabaseId
)
const { project } = data ?? {}
const DB_FIELDS = ['db_host', 'db_name', 'db_port', 'db_user', 'inserted_at']
const emptyState = { db_user: '', db_host: '', db_port: '', db_name: '' }
const connectionInfo = readReplicasEnabled
? pluckObjectFields(selectedDatabase || emptyState, DB_FIELDS)
: pluckObjectFields(project || emptyState, DB_FIELDS)
const connectionTld =
projectDetails?.restUrl !== undefined
? new URL(projectDetails?.restUrl ?? '').hostname.split('.').pop() ?? 'co'
: 'co'
const handleCopy = (id: string) => {
const labelValue = CONNECTION_TYPES.find((type) => type.id === id)?.label
Telemetry.sendEvent(
{
category: 'settings',
action: 'copy_connection_string',
label: labelValue ? labelValue : '',
},
telemetryProps,
router
)
}
const connectionStrings =
isSuccessPoolingInfo && poolingConfiguration !== undefined
? getConnectionStrings(connectionInfo, poolingConfiguration, {
projectRef,
usePoolerConnection: snap.usePoolerConnection,
})
: { uri: '', psql: '', golang: '', jdbc: '', dotnet: '', nodejs: '', php: '', python: '' }
const poolerTld =
isSuccessPoolingInfo && poolingConfiguration !== undefined
? getPoolerTld(poolingConfiguration?.connectionString)
: 'com'
const poolerConnStringSyntax =
isSuccessPoolingInfo && poolingConfiguration !== undefined
? constructConnStringSyntax(poolingConfiguration?.connectionString, {
selectedTab,
usePoolerConnection: snap.usePoolerConnection,
ref: projectRef as string,
cloudProvider: isProjectLoading ? '' : project?.cloud_provider || '',
region: isProjectLoading ? '' : project?.region || '',
tld: snap.usePoolerConnection ? poolerTld : connectionTld,
portNumber: snap.usePoolerConnection
? poolingMode === 'transaction'
? poolingConfiguration?.db_port.toString()
: '5432'
: connectionInfo.db_port.toString(),
})
: []
useEffect(() => {
if (
readReplicasEnabled &&
connectionString !== undefined &&
connectionStringsRef.current !== undefined
) {
state.setSelectedDatabaseId(connectionString)
connectionStringsRef.current?.scrollIntoView({ block: 'center', behavior: 'smooth' })
}
}, [connectionString])
useEffect(() => {
if (poolingConfiguration?.pool_mode === 'session') {
setPoolingMode(poolingConfiguration.pool_mode)
}
}, [poolingConfiguration?.pool_mode])
return (
<div id="connection-string" className="w-full">
<Panel
className={cn(
'!m-0 [&>div:nth-child(1)]:!border-0 [&>div:nth-child(1)]:!p-0',
appearance === 'minimal' && 'border-0 shadow-none'
)}
bodyClassName={cn(appearance === 'minimal' && 'bg-transparent')}
titleClasses={cn(appearance === 'minimal' && 'bg-transparent')}
title={
<div
ref={connectionStringsRef}
className={cn('w-full flex flex-col', appearance === 'default' ? 'pt-4' : 'pt-0')}
>
<div
className={cn(
'flex items-center justify-between mb-2',
appearance === 'default' && 'px-6'
)}
>
{appearance === 'default' && (
<h5 key="panel-title" className="mb-0">
Connection string
</h5>
)}
<div
className={cn(
'flex items-center gap-x-2 ml-auto',
appearance === 'minimal' ? 'absolute -top-1 right-0' : ''
)}
>
{readReplicasEnabled && <DatabaseSelector />}
<Button asChild type="default" icon={<ExternalLink strokeWidth={1.5} />}>
<a
target="_blank"
href="https://supabase.com/docs/guides/database/connecting-to-postgres"
>
Documentation
</a>
</Button>
</div>
</div>
<Tabs
type="underlined"
size="tiny"
activeId={selectedTab}
baseClassNames={cn(
'!space-y-0 px-6 -mb-[1px]',
appearance === 'minimal' && '-mt-1 px-0'
)}
onChange={setSelectedTab}
>
{CONNECTION_TYPES.map((type) => (
<Tabs.Panel key={type.id} id={type.id} label={type.label} />
))}
</Tabs>
<Separator />
</div>
}
>
<Panel.Content className={appearance === 'minimal' && 'px-0'}>
{isLoading && <ShimmeringLoader className="h-8 w-full" />}
{isError && <AlertError error={error} subject="Failed to retrieve database settings" />}
{isSuccess && (
<div className="flex flex-col gap-y-4 pt-2">
<UsePoolerCheckbox
id="connection-string"
checked={snap.usePoolerConnection}
poolingMode={poolingMode}
onCheckedChange={snap.setUsePoolerConnection}
onSelectPoolingMode={setPoolingMode}
/>
{!snap.usePoolerConnection && <IPv4DeprecationNotice />}
<Input
copy
readOnly
disabled
className="input-mono [&>div>div>div>input]:text-xs [&>div>div>div>input]:opacity-100"
value={
poolingMode === 'transaction'
? connectionStrings[selectedTab]
: connectionStrings[selectedTab].replace('6543', '5432')
}
onCopy={() => handleCopy(selectedTab)}
/>
</div>
)}
</Panel.Content>
{poolerConnStringSyntax.length > 0 && (
<>
<Separator />
<Panel.Content className={cn('!py-3 space-y-2', appearance === 'minimal' && 'px-0')}>
<Collapsible_Shadcn_>
<CollapsibleTrigger_Shadcn_ className="group [&[data-state=open]>div>svg]:!-rotate-180">
<div className="flex items-center gap-x-2 w-full">
<p className="text-xs text-foreground-light group-hover:text-foreground transition">
How to connect to a different database or switch to another user
</p>
<ChevronDown
className="transition-transform duration-200"
strokeWidth={1.5}
size={14}
/>
</div>
</CollapsibleTrigger_Shadcn_>
<CollapsibleContent_Shadcn_ className="my-2">
<div className="text-foreground-light">
<p className="text-xs">
You can use the following URI format to switch to a different database or user
{snap.usePoolerConnection ? ' when using connection pooling' : ''}.
</p>
<p className="text-sm font-mono tracking-tight text-foreground-lighter">
{poolerConnStringSyntax.map((x, idx) => {
if (x.tooltip) {
return (
<Tooltip.Root key={`syntax-${idx}`} delayDuration={0}>
<Tooltip.Trigger asChild>
<span className="text-foreground text-xs">{x.value}</span>
</Tooltip.Trigger>
<Tooltip.Portal>
<Tooltip.Portal>
<Tooltip.Content side="bottom">
<Tooltip.Arrow className="radix-tooltip-arrow" />
<div
className={[
'rounded bg-alternative py-1 px-2 leading-none shadow',
'border border-background',
].join(' ')}
>
<span className="text-xs text-foreground">{x.tooltip}</span>
</div>
</Tooltip.Content>
</Tooltip.Portal>
</Tooltip.Portal>
</Tooltip.Root>
)
} else {
return (
<span key={`syntax-${idx}`} className="text-xs">
{x.value}
</span>
)
}
})}
</p>
</div>
</CollapsibleContent_Shadcn_>
</Collapsible_Shadcn_>
{selectedTab === 'python' && (
<Collapsible_Shadcn_>
<CollapsibleTrigger_Shadcn_ className="group [&[data-state=open]>div>svg]:!-rotate-180">
<div className="flex items-center gap-x-2 w-full">
<p className="text-xs text-foreground-light group-hover:text-foreground transition">
Connecting to SQL Alchemy
</p>
<ChevronDown
className="transition-transform duration-200"
strokeWidth={1.5}
size={14}
/>
</div>
</CollapsibleTrigger_Shadcn_>
<CollapsibleContent_Shadcn_ className="my-2">
<div className="text-foreground-light text-xs grid gap-2">
<p>
Please use <code>postgresql://</code> instead of <code>postgres://</code> as
your dialect when connecting via SQLAlchemy.
</p>
<p>
Example:
<code>create_engine("postgresql+psycopg2://...")</code>
</p>
<p className="text-sm font-mono tracking-tight text-foreground-lighter"></p>
</div>
</CollapsibleContent_Shadcn_>
</Collapsible_Shadcn_>
)}
</Panel.Content>
</>
)}
</Panel>
</div>
)
}