mirror of
https://github.com/supabase/supabase.git
synced 2026-10-09 03:15:06 +03:00
Kimaswa Emmanuel YusufuandChris Chinchilla
d35e8081d0
Reading through the guides and troubleshooting docs I found a set of
code examples that don't parse or run as written. Each is a small,
self-contained fix:
- **troubleshooting/postgres-logs**: the `regexp_contains(...)` call was
missing its closing parenthesis.
- **troubleshooting/rls-performance**: the PL/pgSQL `return` statement
was missing its terminating semicolon.
- **troubleshooting/supavisor-faq**: the `CREATE USER ... WITH PASSWORD`
string literal was unterminated (missing closing quote).
- **troubleshooting/google-auth-fails**: missing comma between
`provider` and `options` in the `signInWithOAuth` object literal.
- **integrations/supabase-for-platforms**,
**database/extensions/pg_graphql**,
**deployment/branching/working-with-branches**: missing commas between
JSON properties.
- **database/extensions/pgjwt**: the default algorithm was written
`'HSA256'`; the real default is `'HS256'` (used in both `sign` and
`verify`).
- **auth/auth-email-passwordless** (Dart): `signinwithotp` should be
`signInWithOtp`.
- **auth/third-party/firebase-auth**: `async function
setRoleCustomClaim() => {` mixed a function declaration with arrow
syntax.
- **storage/management/copy-move-objects**: the storage helper is
`storage.foldername(name)`, not `storage.folder(name)`.
- **troubleshooting/hsnw-index**: prose referred to
`maintance_work_mem`; the setting is `maintenance_work_mem` (the SQL in
the same file spells it correctly).
- **troubleshooting/pgcron-debugging**: a stray double quote inside the
`cron.job_run_details` code span.
13 files, all one-line fixes. Happy to split if you'd prefer.
<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
## Summary by CodeRabbit
* **Documentation**
* Corrected code examples across authentication, database, storage, and
troubleshooting guides
* Fixed method naming and syntax errors in code snippets (Dart auth,
Node.js Firebase, SQL functions)
* Updated API signatures and variable names for accuracy
* Improved JSON formatting in example payloads
* Corrected typos in documentation text
<!-- end of auto-generated comment: release notes by coderabbit.ai -->
---------
Co-authored-by: Chris Chinchilla <chris@chrischinchilla.com>
108 lines
3.2 KiB
Plaintext
108 lines
3.2 KiB
Plaintext
---
|
|
id: 'storage-management'
|
|
title: 'Copy Objects'
|
|
description: 'Learn how to copy and move objects'
|
|
subtitle: 'Learn how to copy and move objects'
|
|
sidebar_label: 'Copy / Move Objects'
|
|
---
|
|
|
|
## Copy objects
|
|
|
|
You can copy objects between buckets or within the same bucket. Currently only objects up to 5 GB can be copied using the API.
|
|
|
|
When making a copy of an object, the owner of the new object will be the user who initiated the copy operation.
|
|
|
|
### Copying objects within the same bucket
|
|
|
|
To copy an object within the same bucket, use the `copy` method.
|
|
|
|
```javascript
|
|
import { createClient } from '@supabase/supabase-js'
|
|
const supabase = createClient('your_project_url', 'your_supabase_api_key')
|
|
|
|
// ---cut---
|
|
await supabase.storage.from('avatars').copy('public/avatar1.png', 'private/avatar2.png')
|
|
```
|
|
|
|
### Copying objects across buckets
|
|
|
|
To copy an object across buckets, use the `copy` method and specify the destination bucket.
|
|
|
|
```javascript
|
|
import { createClient } from '@supabase/supabase-js'
|
|
const supabase = createClient('your_project_url', 'your_supabase_api_key')
|
|
|
|
// ---cut---
|
|
await supabase.storage.from('avatars').copy('public/avatar1.png', 'private/avatar2.png', {
|
|
destinationBucket: 'avatars2',
|
|
})
|
|
```
|
|
|
|
## Move objects
|
|
|
|
You can move objects between buckets or within the same bucket. Currently only objects up to 5GB can be moved using the API.
|
|
|
|
When moving an object, the owner of the new object will be the user who initiated the move operation. Once the object is moved, the original object will no longer exist.
|
|
|
|
### Moving objects within the same bucket
|
|
|
|
To move an object within the same bucket, you can use the `move` method.
|
|
|
|
```javascript
|
|
import { createClient } from '@supabase/supabase-js'
|
|
const supabase = createClient('your_project_url', 'your_supabase_api_key')
|
|
|
|
// ---cut---
|
|
const { data, error } = await supabase.storage
|
|
.from('avatars')
|
|
.move('public/avatar1.png', 'private/avatar2.png')
|
|
```
|
|
|
|
### Moving objects across buckets
|
|
|
|
To move an object across buckets, use the `move` method and specify the destination bucket.
|
|
|
|
```javascript
|
|
import { createClient } from '@supabase/supabase-js'
|
|
const supabase = createClient('your_project_url', 'your_supabase_api_key')
|
|
|
|
// ---cut---
|
|
await supabase.storage.from('avatars').move('public/avatar1.png', 'private/avatar2.png', {
|
|
destinationBucket: 'avatars2',
|
|
})
|
|
```
|
|
|
|
## Permissions
|
|
|
|
To **copy** objects, users need `select` permission on the source object and `insert` permission on the destination object. If the user also has `update` permission, the copy can be performed as an upsert, which will overwrite the destination object if it already exists.
|
|
|
|
To **move** objects, users need `select` and `update` permissions on the object.
|
|
|
|
For example:
|
|
|
|
```sql
|
|
create policy "User can select their own objects (in any buckets)"
|
|
on storage.objects
|
|
for select
|
|
to authenticated
|
|
using (
|
|
owner_id = (select auth.uid())
|
|
);
|
|
|
|
create policy "User can insert in their own folders (in any buckets)"
|
|
on storage.objects
|
|
for insert
|
|
to authenticated
|
|
with check (
|
|
(storage.foldername(name))[1] = (select auth.uid())
|
|
);
|
|
|
|
create policy "User can update their own objects (in any buckets)"
|
|
on storage.objects
|
|
for update
|
|
to authenticated
|
|
using (
|
|
owner_id = (select auth.uid())
|
|
);
|
|
```
|